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The System logic Library is intended for people who debug or 
modify the MVS control program. It describes the logic of most 
MVS control program functions that are performed after master 
scheduler initialization completes. Refer to MVS/XA System 
Initializ ation Logic for detailed information about the MVS 
control program prior to this point; refer to the MVS/XA 
Overview for general information about the MVS control program 
and the relationships among the components; and refer to the 
list of Corequisite Reading and Related Publications in the 
Master Preface to obtain the names of publications that describe 
some of the components not in the System Logic library . 


HOW THE LIBRARY IS ORGANIZED 

MULTIPLE VOLUMES 


The System_Logic Library consists of multiple volumes. Volume 1 
contains the master preface/ the master table of contents, the 
master figure list, and the master index for the remaining 
volumes in the library. The last volume, or the module 
description volume, contains module descriptions for all of the 
modules in the components documented in the System Logic Library 
and an index. Each of the other volumes, or the component 
volumes, contains its own table of contents and index of the 
information in that particular volume. The component volumes 
describe the logic of the components in the MVS control program. 


ORGANIZATION OP THE COMPONENTS 

The component volumes are organized alphabetically by section 
name. Each section contains information about one or more of 
the components in the MVS control program. A section contains 
more than one component when the components are closely related, 
frequently referenced at the same time, and not so large that 
they require a volume of their own. 

A three or four character mnemonic is associated with each 
section and is used in all figure, diagram, and page numbers in 
that section. For example, the mnemonic ASM is associated with 
the section "Auxiliary Storage Management." 

All figures in this section are identified as Figure ASM-n, all 
diagrams as Diagram ASM-n, and all pages as ASM-n, where n 
represents the specific figure, diagram, or page number. 

Whenever possible, existing component acronyms are used as the 
mnemonic for a section. The mnemonics are in alphabetic order. 
The Table of Section Names in the Master Preface lists the 
section names, the components included in each section (if a 
section contains more than one component), the mnemonics for the 
sections, and the volume and order number for each volume. 


HOW TO USE THE LIBRARY 

To use this library efficiently, readers must be able to find 
the information that they need quickly; they must be aware of 
the types of information provided for each component; and they 
must know how to obtain additional information before 
referencing the System Logic Library . The following topics 
cover these points. 
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FINDING INFORMATION USING THE VOLUME TITLES 

As readers become familiar with the section names* their 
mnemonics* and contents* they will be able to use the System 
Logic Library as they would an encyclopedia and go directly to 
the volume that they need. To help readers locate the correct 
volume* section mnemonics are included in the titles of the 
component volumes. If a volume contains one section* the 
mnemonic for that section is specified; if a volume contains 
more than one section* the mnemonics for the first and last 
section in the volume are specified. 

The Table of Section Names in the Master Preface contains a list 
of section names and mnemonics. It provides a quick reference 
to the mnemonics and the components included in each section. 


FINDING INFORMATION USING THE MASTER INDEX 

Readers who are not sure which section contains the information 
they are looking for can locate information by using the master 
index in Volume 1. For the component volumes* the page number 
in an index entry consists of the mnemonic for the section* the 
volume number as a superscript on the mnemonic* and the page 
number* for the last volume (which contains the module 
descriptions)* the page number consists of the volume number 
instead of a mnemonic and the page number. For examples 

ASM-12 refers to the "Auxiliary Storage Management" section 
in volume 3* page 12. 

The volume number and section mnemonic are not repeated for 
successive references to the same section in a single entry in 
the master index; for example* ASM-12* 17 refers to both pages 
ASM-12 and ASM-17. Familiarity with the library will aid in 
locating the exact volume in which a component is documented. 


INFORMATION PROVIDED FOR EACH COMPONENT 

The following information is provided for each of the components 
described in the System Logic Library . 

1. An introduction that summarizes the component's function 

2. Control block overview figures that show significant fields 
and the chaining structure of the component's control blocks 

3. Process flow figures that show control flow between the 
component's object modules 

4. Module information that describes the functional 
organization of a program. This information can be in the 
form of i 

• Method of Operation diagrams and extended descriptions. 

• Automatically-generated prose and logic diagrams. The 
automated module information is generated from the 
module prologue* block and line comments within the 
code* and the code itself. It consists of four partsi 
module description* module operation summary* diagnostic 
aids* and a logic diagram. 

5. Module descriptions that describe the operation of the 
modules 

Some components also include diagnostic techniques information* 
used for debugging the component* following the Introduction. 

Items 1 through 4 are located in the component volumes; item 5 
is located in the last volume. 
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FURTHER INFORMATION 

For more information about the System Logic library, including 
the order numbers of the library's publications# see the Master 
Preface. 
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SUMMARY OF AMENBMEMTS 


Summary of Amendments 
for LY28-1765-0 

for MVS/System Product Version 2 Release 2.0 


This publication is new for MVS System Product Version 2 Release 
2.0. It contains information that was reorganized from the 
MVS/XA System Logic Library Volume 13 . LY28-1254-2, which 
applies to MVS/XA System Product Version 2 Release 1.7. 


This publication contains changes to support MVS/System Product 
Version 2 Release 2.0. The changes includet 

• New module 

IEAVESLX 

• Changed modules 

IEAVELK 

IEAVELCR 

IEAVEVRR 

IEAVESTU 

• Minor technical and editorial changes throughout the 
publication. 
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INTRODUCTION 


Supervisor control includes the following services! 

• The service manager/ which schedules requests. 

• The dispatcher/ which dispatches work. The dispatcher and 
memory switch are described in the DISP section of the 
SysJLej!L,Lo^Lp^.i bar*: • 

• The various interruption handlers/ which route control to 
appropriate routines for given interruptions. 

• Interprocessor communications (IPC)/ which senses or changes 
the hardware status of another processor. 

• The exit effectors/ which provide a mechanism for scheduling 
asynchronous exits. 

• The lock managers/ which permit serialization of system 
resources. 

• Spin loop timeout/ which prevents intei—processor deadlock 
situations from occurring. 

• Intersect serialization function/ which serializes the 
dispatching queues. 

• Validity checking routines/ which validate queues/ control 
blocks and addresses. 

• Supervisor control recovery routines/ which provide 
functional recovery for supervisor control. 


SUPERVISOR CONTROLSERVICES 

The following topics give a brief overview of the supervisor 
control services. 


SERVICE MANAGEMENT 


In order to facilitate multiprocessing/ MVS uses a category of 
facilities/ called service management/ to schedule system 
services. Service management consists oft 

• The SCHEDULE macro instruction/ which allows new service 
requests to be entered into the queue of dispatchable work 
with a minimal amount of overhead. 

• A control block/ supplied to SCHEDULE as input and called a 
service request block (SRB)/ which represents a service 
request. The SRB contains information needed to dispatch 
the routine. 

• The PURGEDQ macro instruction/ which allows service requests 
to be terminated. 

Figure 1 on page SUP-4 shows the basic pointer structure 
utilized by the service management facilities. This structure 
incorporates two levels of system priority/ global and local. 
SRBs queued off the SVT are global SRBs; SRBs queued off the 
ASCB are local SRBs. 


LY28-1765-0 (c) Copyright IBM Corp. 1987 


Introduction SUP-3 




"Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


SRB 



Figure 1. SRB Scheduling Pointer Structure 


At the global level, there are two queues, the global service 
management queue (6SMQ) and the global service priority list 
(GSPL). Likewise, at the local level there are two queues, the 
LSMQ and the LSPL. In addition, there is a single SMQ at the 
local level (SVTLSMQ) that is maintained for compatibility 
reasons. The SMQs are used as staging queues, and the SPLs are 
used as dispatching queues. 

Service requests scheduled at the global level are placed on the 
appropriate global queue and have a priority higher than any 
address space, regardless of the actual address space in which 
they will be dispatched. Service requests scheduled at the 
local level will be placed on the single local SMQ (SVTLSMQ) or 
the appropriate local queue in the address space in which the 
SRB will be dispatched. Any SRBs scheduled to the single local 
SMQ will eventually be moved to the appropriate local queue in 
the address space in which it will be dispatched. 

Service requests scheduled at a local level have a priority 
equal to the address space in which they will be dispatched, but 
higher than any task within that address space. 

These scheduled routines have the following characteristics! 

• They receive control in supervisor state. 

• They may execute enabled for interruptions, but will not 
lose control to higher priority work unless they are 
suspended for a page fault, a lock, or a page fix. 

• They may free the SRB control block once they get control. 

• They may not issue SVCs. 
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• They may execute in any designated address space. 

To use the service management facility* the user musts 

1. Construct the SRB. 

2. Schedule it* using the SCHEDULE macro* to the appropriate 
global or local queue. 

The user will then continue to execute until he is interrupted* 
causing an entry into the dispatcher. 


INTERRUPTION HANDLERS 

The interruption handlers route control to the appropriate 
routines after machine interruptions occur. Any interruption 
causes processor control to be taken from the executing program 
and given to an interruption handling routine. 

Any interruption causes the current PSN to be saved as the old 
PSH* and the new PSW to be loaded. This new PSW passes control 
to the appropriate interruption-handling routine. 

The interruption handlers processs 

• SVC interruptions* which occur when an SVC instruction is 
executed. The SVC FLIH (first level interruption handler) 
determines which SVC routine the requester wants and passes 
control to it. 

• I/O interruptions* which occur when a channel or device 
signals a change of status. For example* an I/O operation 
terminates* an error occurs* or a device becomes ready. The 
I/O FLIH branches to the I/O supervisor* which performs the 
I/O services and handles I/O errors. 

• External interruptions* which occur fort 

— Timer interruptions (for processor timer expiration* 

clock comparator interruption* or clock synchronization 
failure* see the TIME section of the System Logic 

Lib ra ry)* 

— Hitting interrupt key (when the operator presses 
interrupt key on the console)• 

— External calls (when remote pendable signal routine 
signals another processor). 

— Emergency signals (when machine check handler or remote 
immediate signal routine signals another processor). 

— Service signal interruptions (resulting from the Service 
Processor Call SVC 122). 

— Malfunction alerts (caused by machine failure of another 
processor). 

The external FLIH determines the cause of the interruption 
and branches to the external service routine. 

• Restart interruptions* which occur when the operator 
initiates restart on the system operator's console* or when 
a system program issues a SIGP (signal processor) 
instruction with restart order code. The restart FLIH 
routes control to RTM (recovery termination management). 

• Program interruptions* which may be caused by program errors 
(invalid operation* protection exception); page faults or 
segment faults (caused by referencing a page not in main 
storage); event monitoring (caused by a monitor call 
instruction (MC) or a program event recording (PER) 
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interruption). The program FLIH determines the cause of the 

interruption, and does one or more of the followings 

— Calls real storage management on paging exceptions to 
determine if this is a valid page fault, and if so, to 
initiate processing to bring the page into real storage. 

— Calls the generalized trace facility (GTF) for tracking. 

— Calls RTM if the program exception appears to be a 
program error. 

~ Calls the vector SLIH to build the environment required 
for using the vector feature. 


ZNTERPROCESSOR COMMUNICATIONS (IPC) 

Interprocessor communications (IPO include the signal service 
routines, plus the external call and emergency signal SLIHs 
(second level interruption handlers). The main purpose of IPC 
consists of sensing or changing the hardware status of another 
processor or causing special routines to be invoked on another 
processor. 

The signal service routines perform two different types of 
signal services — direct and remote. The direct signal service 
(IEAVEDR), invoked via the DS6NL macro, uses the signal routine, 
IEAVES6P, to issue the signal to modify, sense or alter the 
physical state of a specific processor. The remote signal 
services, (IEAVERI or IEAVERP), invoked via the RISGNL or RPSGNL 
macros, use the signal routine, IEAVESGP, to issue the emergency 
signal or the external call signal to route control to a routine 
on a specific processor. 


Direct Signal Services 

The direct signal function is invoked via the DSGNL macro. The 
direct service is defined for those control program functions 
that require the modification or sensing of the physical state 
of one of the configured processors. 

The direct signal function consists of the following: 

• IEAVEDR executes on the sending processor to validate the 
DSGNL request and to set up the interface to IEAVESGP so 
that the SIGP instruction can be issued. 

• IEAVESGP (signal routine) executing on the sending processor 
issues the SIGP for one of the following order codes: 

— Sense 
— Start 

- Stop 

— Restart 

— Stop and Store Status 
— Initial CPU Reset 

- CPU Reset 

— Set Prefix Register 

— Store Status at Address 

• The specified receiving process©r f s physical state is sensed 
or altered. 
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Remote Signal services 

There are two types of remote signal services* 

• Remote immediate signal — invoked via the RISGNL macro. 

• Remote pendable signal — invoked via the RPSGNL macro. 

The remote immediate signal function consists of the followings 

• IEAVERI, executing on the sending processor, sets up the 
interface to the receiving routine. 

• IEAVESGP (signal routine), executing on the sending 
processor, issues the emergency signal SIGP instruction. 

• IEAVEES (the emergency signal SLIH) receives control from 
the external FLIH on the receiving processor and routes 
control to the receiving routine. 

The remote pendable signal function consists of the followings 

• IEAVERP (executing on the sending processor) indicates to 
the receiving processor what functions to perform. 

• IEAVESGP (signal routine) also executing on the sending 
processor, issues the external call SIGP. 

• IEAVEXS (the external call SLIH) receives control from the 
external FLIH on the receiving processor and routes control 
to the receiving routine. 


EXIT EFFECTORS (SCHEDULING EXIT ROUTINES) 

A service exists whereby a program may request that a 
user-defined exit routine execute asynchronously. System 
routines use this service to handle asynchronous events such as 
end-of-task condition, expiration of a timer interval, or 
special I/O handling (for example, tape label checking or I/O 
error checking). 

The scheduling of user exit routines, called asynchronous exit 
routines, is handled by three supervisor routines: the stage 1 
exit effector, the stage 2 exit effector, and the stage 3 exit 
effector. 

In order to schedule a routine to execute asynchronously under a 
specific task, an interrupt request block, IRB, must be placed 
on that task’s RB chain. The following describes the control 
flow for that mechanism. 

1. The user must first create and format the IRB via the CIRB 
macro instruction. CIRB invokes the stage 1 exit effector, 
which obtains storage from LSQA and formats the IRB. 

2. The user must set up the interface (to the stage 2 exit 
effector), which is in one of the following forms: 

a. Interrupt queue element (IQE). This contains the TCB 
and IRB addresses. 

b. Request queue element (RQE). This is exclusively a data 
management interface, allowing asynchronous exits to be 
scheduled from I/O appendages. The RQE contains the TCB 
and IRB addresses. 

c. Service request block (SRB). This is used by only IOS 
when scheduling a non-resident error recovery procedure. 
In each address space there is a predetermined task 
designated as the error task* (Its address is contained 
in ASXBETSK). Each address space also has a 
pre-formatted system IRB (SIRB). An SRB passed to stage 
2 exit effector represents a request to schedule the 
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SIRB to the error task. The SIRB always gives control 
to the IOS error recovery procedure loader. 

The user branch-enters the stage 2 exit effector with either 
the address of an IQE/ RQE/ or SRB. Stage 2 queues the 
request off of the ASXB for the current address space and 
returns to the caller. 

3. Hhen the dispatcher checks an address space for available 
work/ it determines if there are queued requests. If so> it 
invokes the stage 3 exit effector. 

4. Stage 3 processes the queued requests. Stage 3 dequeues the 
requests (IQE/ RQE/ or SRB) from the asynchronous exit queue 
and places the associated IRB on the indicated task's RB 
chain. 

Hhen the dispatcher dispatches that task/ with the IRB 
highest on the RB chain/ the asynchronous exit will get 
control. 

See Figure 2 on page SUP-9 for an illustration of exit effector 
data structure. 
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Stage 1 


IQE 

□ 




IRB 



— PSW for asynchronous exit 
entry point 


— Entry point of 
asynchronous exit 


Stage 2 


PSA IQE TCB 



Stage 3 


IRB 



Figure 2. Asynchronous Exit Effector Data Structure 
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LOCK MANAGEMENT 


In a multiprocessor system* some method of serialization must be 
used to prevent interference between processors competing for a 
resource. MVS/XA uses locking to serialize resources. 

There are two types of locks; spin and suspend. 


Spin Locks 


An unconditional request for a spin lock causes a disabled loop 
on the processor until the lock becomes available if it cannot 
be immediately obtained. The owner of a spin lock must run 
disabled for I/O and external interrupts and cannot take a page 
fault. 

A list of global locks in hierarchical order* highest first* are 
listed below. 


Lock Name 

Description 

RSMGL 

Real storage management global lock - serializes 

RSM global resources. 

VSMFIX 

Virtual storage management fixed subpools lock - 
serializes VSM global queues. 

ASM 

Auxiliary storage management lock - serializes ASM 
resources on an address space level. 

ASM6L 

Auxiliary storage management global lock - 
serializes ASM resources on a global level. 

RSMST 

Real storage management steal lock - serializes RSM 
control blocks on an address space level when it is 
not known which address space locks are currently 
held. 

RSMCM 

Real storage management common lock - serializes 

RSM common area resources (such as page table 
entries). 

RSMXM 

Real storage management cross memory lock - 
serializes RSM control blocks on an address space 
level when serialization is needed to a second 
address space. 

RSMAD 

Real storage management address space lock - 
serializes RSM control blocks on an address space 
level. 

RSM 

Real storage management lock (shared/exclusive) - 
serializes RSM functions and resources on a global 
level. 

VSMPAG 

Virtual storage management pageable subpools lock - 
serializes the VSM work area for VSM pageable 
subpools. 

DISP 

Global dispatcher lock - serializes the ASVT and 
the ASCB dispatching queue. 

SALLOC 

Space allocation lock - serializes receiving 
routines that enable a processor for an emergency 
signal or malfunction alert. 

IOSYNCH 

I/O supervisor synchronization lock - serializes, 
using a table of lockwords, IOS resources. 
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Lock Name 

Description 

IOSUCB 

I/O supervisor unit control block lock - serializes 
access and updates to the UCBs. There is one 

IOSUCB lock per UCB. 

SRM 

System resources management lock - serializes SRM 
control blocks and associated data. 

TRACE 

Trace lock (shared/exclusive) - serializes the 
reading (shared) and writing (exclusive) of the 
system trace buffer. 

CPU 

Processor lock - provides system-recognized (legal) 
disablement. Note that the CPU lock has no 
hierarchy in respect to the other spin type locks. 
However* once obtained* no suspend locks can be 
obtained. 


For a more detailed explanation of spin lock managers* refer to 
MVS/_XA_D-iacmostic Techniques . 


Suspend Locks 


A request for a suspend lock suspends the requestor (if the lock 
cannot be obtained immediately) to allow that processor to 
process other work. The owner of a suspend lock can run enabled 
for I/O or external interruptions and can take a page fault. 

The local and cross memory services locks are suspend type 
locks; all others are spin locks. 

A description of the global and local suspend locks and their 
hierarchy are listed below. 


Lock Name 

Type 

Description 

CMSSMF 

Global 

System management facilities cross memory 
services lock - serializes SMF functions and 
control blocks. 1 

CMSEQDQ 

Global 

ENQ/DEQ cross memory services lock - 
serializes ENQ/DEQ functions and control 
blocks. 1 

CMS 

Global 

General cross memory services lock - 
serializes on more than one address space 
where this serialization is not provided by 
one or more of the other global locks. The 

CMS lock provides global serialization when 
enablement is required. 1 

CML 

Local 

Local storage lock - serializes functions and 
storage within an address space other than the 
home address space. There is one CML lock per 
address space. 2 

LOCAL 

Local 

Local storage lock - serializes functions and 
storage within a local address space. There 
is one LOCAL lock per address space. 2 

*The cross memory services locks (CMSSMF* CMSEQDQ* and CMS) are 
equal to each other in the hierarchy. 
z The CML and LOCAL locks are equal to each other in the 
hierarchy. 


For a more detailed explanation of suspend lock managers* refer 
to MV_S/XA_ Diagnostic Techniques . 
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SPIN LOOP TIMEOUT 


A spin loop is a situation in which one processor in a 
multiprocessor environment is unable to communicate with another 
processor or requires a resource currently held by another 
processor. The processor that has attempted communication (Px) 
is the "detecting" or "spinning" processor. The processor that 
has failed to respond (Py) is the "disabled" or "failing" 
processor. 

The "detecting" processor attempts communication with the 
"disabled" processor for a period of time that is determined by 
an excessive spin loop factor located in that processors PCCA 
(PCCAXSLF). This factor, computed by SRM during NIP processing, 
is the approximate number of instructions that the processor 
will execute in 40 seconds. The spinning program on processor Px 
calculates its 40 second spin loop by dividing the spin loop 
factor by the number of instructions in the loop. 

During its loop, the spinning processor periodically "opens a 
window" for a malfunction alert (MFA) or emergency signal (EMS), 
which would indicate that processor Py has malfunctioned. If a 
malfunction occurs, alternate CPU recovery (ACR) is invoked on 
processor Px to take Py offline and free any resources that it 
holds. Px can then exit from its spin loop and continue 
processing. If processor Px completes its spin loop without the 
desired response from processor Py, a spin loop timeout 
condition exists. The spinning routine (on Px) invokes the 
excessive spin notification routine (IEEVEXSN) to inform the 
system operator. The operator has the option of initiating an 
ACR to remove processor Py from the complex or instructing 
processor Px to begin spinning again for another forty seconds. 
This occurs repeatedly until the processor Py releases the 
required resources or is removed from the complex. If the 
identified processor (Py) is removed from the complex via 
alternate CPU recovery (ACR), all global resources held by the 
identified processor (Py) are released so that the spinning 
processor (Px) can continue. 


INTERSECT SERIALIZATION 

The intersect function is used by any routine that alters the 
dispatching queues. This mechanism indicates to the dispatcher 
that it should not begin processing until the intersecting 
function has completed. In the same manner, a routine cannot 
intersect until the dispatcher has completed. The two levels of 
intersect arei 

• Global — used by any routine that modifies the ASCB queue 
or the dispatchability of an ASCB. The dispatcher lock must 
be held before requesting the global intersect. 

• Local — used by any routine that modifies the TCB queue or 
the dispatchability of a TCB. The local lock must be held 
before requesting the global intersect. 


VALIDITY CHECKING 


The validity check routine determines whether the storage 
protect key for a specified address or address range matches the 
task's assigned protect key. 
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SUPERVISOR CONTROL RECOVERY 

Supervisor control recovery routines can receive control by one 
of three mechanismsi 

• Direct interface with RTM 

• Normal SETFRR/ESTAE mechanism 

• Supervisor control FRR stack mechanism 


Direct Interface With RTM 

There are a number of routines (IEAVELCR, IEAVELKR* IEAVESLR, 
IEAVEVRR) called on SL1H mode entry to RTM to validate certain 
basic system information. 


Normal SETFRR/ESTAE Mechanism 

A number of supervisor control functions use the standard 
SETFRR/ESTAE mechanism to control the recovery environment. 


Supervisor Control FRR Stack Mechanism 

In order to bypass SETFRR processing on high-performance paths* 
a multiple FRR stack mechanism is used to provide recovery for 
some supervisor control routines. 

There is a pointer in the PSA to the FRR stack that this 
processor is using currently. When an error occurs* RTM will 
route control only to FRRs on that stack. (See the RTM section 
of the System Logic Library for a description of routing to 
FRRs.) 

For each processor there are eight FRR stacks — a normal stack 
and seven super stacks* which are used to provide recovery for 
supervisor control functions. The current stack pointer will 
always point to one of the stacks. 

If the dispatcher or any of the interruption handlers receives 
control* rather than issuing a SETFRR to establish recovery* it 
will flip the current stack pointer to point to the appropriate 
super FRR stack. 

If a routine called by a supervisor control function issues a 
SETFRR* the FRR entry will appear on the current stack. If an 
error occurs while a super stack is current* then RTM will first 
route control to all the FRRs on that stack and will then route 
control to the super FRR routine (IEAVESPR). 

See Figure 3 on page SUP-14 for an illustration of the 
supervisor control recovery data structure. 
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Part 2 
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Figure 3. Supervisor Control Recovery Data Structure 
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MODULE NAMING CONVENTIONS 


Each supervisor control module name consists of at least seven 
characters. The first four characters are 'IEAV'. The remaining 
characters are an abbreviation of the module description. 


ADDRESSING AND RESIDENCY MODES 

The addressing and residency mode of the supervisor control 
modules vary. The modules with their respective addressing and 
residency modes are listed below. 


Module 

RMODE 

AMODE 

IEAVEADV 

24 

ANY 

IEAVEBBR 

ANY 

31 

IEAVCKRS 

ANY 

31 

IEAVCRVF 

ANY 

31 

IEAVECVB 

24 

ANY 

IEAVECMS 

24 

ANY 

IEAVEDR 

ANY 

31 

IEAVEEEO 

ANY 

31 

IEAVEEE2 

24 

ANY 

IEAVEES 

ANY 

31 

IEAVEEXP 

24 

ANY 

IEAVEEXT 

ANY 

31 

IEAVEF00 

24 

ANY 

IEAVEINT 

24 

ANY 

IEAVEl0 

24 

31 

IEAVEJST 

ANY 

31 

IEAVELCR 

ANY 

31 

IEAVELK 

24 

ANY 

IEAVELKR 

ANY 

31 

IEAVEPCO 

ANY 

31 

IEAVEPC 

ANY 

31 

IEAVEPDR 

ANY 

31 

IEAVEPDO 

24 

31 

IEAVEQVO 

24 ( 

ANY 

IEAVERES 

ANY 

31 

IEAVEREX 

ANY 

31 


Module 

RMODE AMODE 

IEAVERI 

ANY 

31 

IEAVERP 

ANY 

31 

IEAVESCR 

ANY 

31 

IEAVESCO 

24 

ANY 

IEAVESGP 

ANY 

31 

IEAVESLK 

24 

ANY 

IEAVESLR 

ANY 

31 

IEAVESLX 

ANY 

31 

IEAVESPR 

ANY 

31 

IEAVESRT 

ANY 

31 

IEAVESTU 

ANY 

31 

IEAVESVC 

24 

ANY 

IEAVETCL 

ANY 

31 

IEAVEVAL 

24 

ANY 

IEAVEVS 

ANY 

31 

IEAVESAR 

ANY 

31 

IEAVEVRR 

ANY 

31 

IEAVEXS 

ANY 

31 

IEAVFRLK 

ANY 

31 

IEAVLKRM 

ANY 

31 

IEAVELRM 

ANY 

31 

IEAVSSAF 

ANY 

31 

IEAVMVCO 

ANY 

31 

IEAVSPDM 

ANY 

31 

IEAVVMCH 

ANY 

31 

IEAVVSR 

ANY 

31 

IEAVVSRB 

ANY 

31 


For additional information on addressing and residency mode* see 
System Programming Libraryt 31-Bit Addressing . 
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DIAGNOSTIC TECHNIQUES 


This section contains problem analysis for the followingi 

• SRB/SSRB pool manager 

• STOP/RESET services 

• SUSPEND/RESUME/TCTL services 


PROBLEM ANALYSIS FOR THE SRB/SSRB POOL MANAGER 

The SRB/SSRB pool manager* IEAVESPM* obtains and frees SRBs from 
the SRB pool and SSRBs (with their associated XSBs) from the 
SSRB pool. System routines (in key 0* supervisor state) issue 
the GETSRB* FREESRB* GETSSRB* and FREESSRB macros to request the 
pool manager services. 


SRB/SSRB POOL MANAGER ENTRY POINTS 

The pool manager entry points arei 

IEAVSPM1 — entered key 0* supervisor state* enabled for DAT* 
system mode acceptable to SETFRR (not EUT)* no 
locks required (except the CPU lock might be 
required for UNCOND and EXPAND type requests). 

This entry point is called by the GETSRB macro and 
obtains an SRB and six-word parameter area from the 
SRB pool in subpool 245. The SRB is initialized as 
followst 

— SRB acronym field 

— pointer to the parameter area 

— FREEMAIN flags* which indicate the origin of the 
SRB 

— other fields and the parameter area cleared. 

IEAVSPM2 — entered key 0* supervisor state* enabled for DAT* 
system mode acceptable to SETFRR (not EUT)* no 
locks required (except the CPU lock might be 
required). 

This entry point is called by the GETSSRB macro and 
obtains an SSRB and its associated XSB from the 
SSRB pool in subpool 239. The SSRB/XSB are 
initialized as followst 

— SSRB acronym field 

— pointer to a resource management termination 
routine (RMTR) 

—- pointer to the SSRB save area 

— SSRB pointer to the XSB 

— non-quiesceable and suspended flags set on 

— FREEMAIN flags* which indicate the origin of the 
SSRB/XSB 

— XSB acronym field 

— other fields cleared. 
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1EAVSPM3 — entered key 0* supervisor state* enabled for DAT* 
system mode acceptable to SETFRR (not EUT)* no 

locks required (except the CPU lock might be 

required). 

This entry point is called by the FREESRB macro and 
frees an SRB and its six-word parameter area. If 
the specified SRB acronym field is not the same as 
when the SRB was obtained* the program issuing the 
macro is abended. 

IEAVSPM4 — entered key 0* supervisor state* enabled for DAT* 
system mode acceptable to SETFRR (not EUT)* no 

locks required (except the CPU lock might be 

required). 

This entry point is called by the FREESSRB macro 
and frees an SSRB and its XSB. If the specified 
SSRB acronym field is not the same as when the SSRB 
was obtained* the program issuing the macro is 

abended. 


SRB/SSRB POOL MANAGER RECOVERY CONSIDERATIONS 

When an error occurs* the SRB/SSRB pool manager recovery routine 
(IEAVSPMR) records information about the error in the SDNA. The 
queue verifier routine (IEAVEQV1) then uses an SRB/SSRB 
verification routine in IEAVSPMR to verify that the SRB and SSRB 
pools are intact. Two tests are used to determine if a given 
storage area is a valid SRB or SSRBi (1) the storage address 
must be a valid virtual address* and (2) the acronym field must 
contain the correct acronym. 

If an error is found with a pool* the queue verifier routine 
attempts to repair the pool* which might include removing 
invalid SRBs or SSRBs from their pools. Any removed blocks of 
storage are unavailable for the remainder of the IPL. 


Fixed Data 


The data that the SRB/SSRB pool manager recovery routines record 
in the SDWA isi 

• SDWAMODN — NUCLEUS* pool manager is nucleus resident. 

• SDWACSCT — IEAVESPM, CSECT name. 

• SDWAREXN — IEAVESPM* recovery CSECT name. 

• SDWACID — SC1C5*component ID. 

• SDWASC — descriptive module name. 

• SDWAMLVL — module level information. 

• SDWARRL — IEAVSPMR* recovery routine label. 


Variable Data 


The variable data in the SDWAVRA is recorded in the 

key-length-data format. 

• FRR parm area — the six-word parameter area passed to 

IEAVSPMR by the mainline routine is as followst 

— Mainline CPU footprint — indicates if the CPU lock was 
obtained by the pool manager. 

— FRR CPU footprint — indicates if the CPU lock was held 
on entry to the recovery routine. 

— Return address — contents of register 14 on entry to 
the pool manager (caller's return address). 

• ASCBASID — address space ID of the current ASCB. 

• PSATOLD — address of the current TCB. 
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• General register 14 — contents of register 14 on entry to 
the mainline pool manager (caller's return address). 

• Pool problem information — information recorded by the 
queue verifier routine if problems are found with the SRB or 
SSRB pools. 

• Lock name — CPU, indicates that the CPU lock was held by 
the pool manager mainline routine. 


SRB/SSRB POOL MANAGER ERROR CONDITIONS 

If the IEAVSPM3 (FREESRB) or IEAVSPM4 (FREESSRB) routines are 
called and an error is detected, completion code X'05A V is 
issued and the caller is abended. Register 2 contains the 
address of the invalid SRB or SSRB. 

Refer to System Codes for a description of code X'05A' and 
specific reason codes in register 15. 


PROBLEM ANALYSIS FOR STOP/RESET SERVICES 

When a unit of work (a current task or SRB) has been dispatched 
and is executing, the unit of work might need to be suspended. 
For example, to satisfy a page-in due to a page fault. 

System routines (in key 0, supervisor state) use the stop/reset 
service to suspend and then reset a unit of work. The caller is 
not required to have addressability to the home address space to 
suspend a unit of work, and is not required to have 
addressability to the address space containing the unit of work 
to reset the unit of work. 


STOP/RESET ENTRY POINTS 

The stop/reset entry points are* 

IEAVSUSC — entered disabled, key 0, supervisor state, no locks 
required. 

This entry point is called by the paging supervisor 
to suspend a current task or SRB because a page 
fault occurred, or by system routines (other then 
the paging supervisor) to suspend the current task 
or SRB. 

IEAVSUSF — entered disabled, key 0, supervisor state, no locks 
required. 

This entry point is called by system routines to 
suspend the current task or SRB. The caller may 
specify a number of FRRs not to be copied when the 
normal stack is saved. 

IEAVRSTC — entered disabled, key 0, supervisor state, no locks 
required. 

This entry point is called by the paging supervisor 
or other system routines to reset a task or SRB 
that was suspended. 
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STOP/RESET RECOVERY CONSIDERATIONS 

The stop recovery routine (STOPFRR) records information about 
the error and/ depending on the error/ either attempts to 
restore the system and unit of work to a consistent state/ or 
attempts to complete the stop function. 

The reset recovery routine (RESETFRR) records information about 
the error and then attempts to complete the reset function. 

The reset STERM/ reset schedule/ and reset SRB recovery routine 
(IEAVSCHF) frees the SRB (if one was obtained but not 
scheduled)/ clears the stop/reset super bit (PSASTPRT)/ and 
releases the LOCAL lock (if the LOCAL lock was obtained by the 
calling routine). 


Fixed Data 


The data that the stop/reset recovery routines record in the 
SDWA isi 

• SDHAMODN — NUCLEUS/ stop/reset is nucleus resident. 

• SDWACSCT — IEAVESRT, CSECT name. 

• SDWAREXN — IEAVESRT, recovery routine. 

• SDWACID — SC1C5, component ID. 

• SDWAMLVL — module level information. 

• SDMARRL — STOPFRR, RESETFRR, or IEAVSCHF, label of the 

recovery routine. 


Variable Data 


The variable data in the SDHA is recorded in the key-1ength-data 
format. The variable data recorded by the recovery routine is* 

For the stop recovery (STOPFRR) and the reset recovery 
(RESETFRR) routines* 

• FRR parm area - the six-word parameter area passed to 
STOPFRR and RESETFRR by the mainline routine is as follows* 

— General register 13 - caller's register save area 

address. 

— TCB/SSRB address - address of the TCB or SSRB to be 
reset. 

— RB address - address of the RB if a TCB is to be reset. 

— Request code - type of reset requested (conditional, 

unconditional, or page I/O error), or completion code 
for a termination reset. 

— Flag byte - if X'80', recovery has been entered 
recursively. 

• ASCBASID - address space ID of the current ASCB. 

• PSATOLD - address of the current TCB. 

• General register 14 - contents of register 14 on entry to 
the mainline stop routine (caller's return address). 

• General registers - for STOPFRR, contents of the original 
registers, if they were changed by the recovery routine. 

• Abend code - for STOPFRR, the original abend code, if it was 
changed by the recovery routine. 

For the reset STERM, reset schedule, and reset SRB recovery 
routine (IEAVSCHF)* 
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• FRR parm area - the six-word parameter area passed to 

IEAVSCHF by the mainline routine as follows: 

— SSRB address - address of the SSRB associated with the 
scheduled SRB. (Note that an SSRB is obtained* made to 
look like an SRB* and scheduled as an SRB. The 
remainder of the SSRB is used as a work area by the 
scheduled routine. The SSRB is restored to an SSRB 

before it is returned to the SSRB pool.) 

— Flag byte - recovery footprint flags: 

X^O* - stop/reset super bit footprint* indicates the 
mainline code set the bit. 

X^O 1 - LOCAL lock footprint* indicates the mainline 
code had obtained the LOCAL lock and had not 
released it before the error occurred. 

• ASCBASID - address space ID of the current ASCB. 


• PSATOLD - address of the current TCB. 


• If an SRB was obtained but not scheduled* the following are 
also present in the SDMAVRA: 


— IHASRB - identifies the following control block. 

— SRB - contents of the unscheduled SRB. 

— SRB parm area header - describes the following six-word 
parameter area. 

— SRB parm area - contents of the SRB parameter area. 

Lock name - LOCAL* indicates the LOCAL lock was held. 


STOP/RESET ERROR CONDITIONS 

The stop/reset services issue the X f 059 v completion code when an 
error exists* and abnormally terminates the program requesting 
the service. 

Refer to System Codes for a description of code X , 059* and 
specific reason codes in register 15. 


PROBLEM ANALYSIS FORSUS^ENP/RESUME/TCTL SERVICES 

The SUSPEND/RESUME/TCTL services are used to place an unlocked 
task in a suspended state (SUSPEND)* resume an unlocked task 
from a suspended state (RESUME)* and to transfer control from an 
SRB to an unlocked task (TCTL). These macros can only be issued 
by key 0* supervisor state routines. 

SUSPEND can be issued in any cross memory mode and in task mode; 
it places the caller in a suspended state. Control is returned 
to the caller and the task is suspended only when the task 
incurs an interruption or enters the dispatcher (such as via 
CALLDISP). 

RESUME can be issued in any cross memory mode and in SRB or task 
mode* with current addressability to the address space of the 
TCB that is to be resumed. 

TCTL can be issued in SRB mode and home mode* with current 
addressability to the address space of the task to which control 
is to be transferred. 
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SUSPEND/RESUME/TCTL ENTRY POINTS 

The SUSPEND/RESUME/TCTL entry points are* 

IEAVSPND — entered enabled or disabled/ key 0/ supervisor 
state/ task mode/ no locks held/ any cross memory 
state. 

This entry point is called by the SUSPEND macro and 
places the current TCB/RB or previous RB is a 
suspended state* 

IEAVRSUH — entered enabled/ key 0/ supervisor state/ no locks 
held/ SRB or task mode/ home mode. 

This entry point is called by the RESUME macro to 
resume a task in the home address space. This 
entry point performs an unconditional synchronous 
resume function. The caller must execute enabled 
and hold no locks unless the LOCAL lock is already 
held/ because this entry point can require the 
LOCAL lock to serialize the resume function. This 
is the only entry point where RETURN=N can be 
specified to indicate that control should be 
transferred from the calling SRB to the resumed 
task. 

1EAVRSUS — entered enabled/ key 0/ supervisor state/ no locks 
held/ SRB or task mode/ any cross memory state/ 
current addressability to the resumed TCB. 

This entry point is called by the RESUME macro to 
resume a task in the address space specified by the 
input. Current addressability to the task to be 
resumed must have been established by the caller. 
This entry point performs an unconditional 
synchronous resume function. The caller must 
execute enabled and hold no locks unless the LOCAL 
lock of the address space of the resumed TCB is 
already held/ because this entry point can require 
the specified lock to serialize the resume 
function. 

IEAVRSCS — entered enabled or disabled/ key 0/ supervisor 
state/ SRB or task mode/ any cross memory state/ 
locks can be held/ current addressability to the 
resumed TCB. 

This entry point is called by the RESUME macro to 
resume a task in the address space specified by the 
input. Current addressability to the task to be 
resumed must have been established by the caller. 
This entry point performs a conditional synchronous 
resume function. If serialization to perform the 
resume function is not available/ the function is 
not performed and the caller receives a nonzero 
return code. 

IEAVRSUA — entered enabled or disabled/ key 0/ supervisor 
state/ SRB or task mode, any cross memory state/ 
locks can be held/ current addressability to the 
resumed TCB. 

This entry point is called by the RESUME macro to 
resume a task in the address space specified by the 
input. Current addressability to the task to be 
resumed must have been established by the caller. 
This entry point performs an unconditional 
asynchronous resume function. If serialization to 
perform the resume function is not available/ an 
SRB is obtained and/ asynchronously/ an 
unconditional synchronous function is performed; a 
nonzero return code is returned to the caller. 
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IEAVRSCA — entered enabled or disabled; key 0; supervisor 
state; SRB or task mode; any cross memory state; 
locks can be held; current addressability to the 
resumed TCB. 

This entry point is called by the RESUME macro to 
resume a task in the address space specified by the 
input. Current addressability to the task to be 
resumed must have been established by the caller. 
This entry point performs a conditional 
asynchronous resume function. If serialization to 
perform the resume function is not available; an 
SRB is obtained conditionally; and if successful; 
asynchronously scheduled to perform an 
unconditional synchronous resume function. Return 
codes are returned to the caller to indicate 
whether the SRB could be obtained or not obtained. 

IEAVTCTL — entered enabled or disabled; key 0; supervisor 
state; SRB mode; home mode; no locks held. 


IEAVETCR 


This entry point is called by the TCTL macro to 
transfer control from an SRB to a task in the home 
address space. 


Notes Module IEAVETCL performs the functions just 
described. IEAVETCL resides above the 16 megabyte 
line and executes in 31-bit addressing mode. To 
allow programs that execute in 24-bit addressing 
mode to use SUSPEND/RESUME/TCTL services, the 
macros actually invoke entry points of IEAVEGLU, an 
addressing mode interface module. IEAVEGLU makes 
the transition to 31-bit addressing mode, if 
necessary, and invokes a corresponding entry point 
in IEAVETCL, where the function is performed. The 
following table shows the relationship between the 
entry points in IEAVEGLU and IEAVETCL. 


IEAVEGLU Entry Point 

IEAVSPND 

IEAVRSUH 

IEAVRSUS 

IEAVRSCS 

IEAVRSUA 

IEAVRSCA 

IEAVTCTL 


IEAVETCL Entry Point 

IEAVSPN1 
IEAVRSH1 
IEAVRSS1 
IEAVRSC1 
IEAVRSU1 
IEAVRSA1 
IEAVTCT1 
0 


entered disabled, key 0, supervisor state, any 
cross memory state, SRB or task mode. 


This entry point is called by RTM and performs 
recovery processing for the resume and transfer 
control functions. 
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RESUME/TCTL RECOVERY CONSIDERATIONS 

RESUME/TCTL processing is protected by an FRR (IEAVETCR) that 
receives control from RTM when an error occurs. The FRR records 
debugging information in the SDHA, attempts to restore the 
system and unit of work to a consistent state, and then 
percolates to the caller's recovery routine. 


Fixed Data 


The data that the RESUME/TCTL recovery routine recorded in the 
SDHA isi 

• SDMAMODN — NUCLEUS, nucleus load module. 

• SDHACSCT — IEAVETCL, mainline microfiche name. 

• SDHAREXN — IEAVETCL, recovery microfiche name. 

• SDNACID — SC1C5, component ID. 

• SDNASC — RESUME or TCTL ABEND, subfunction in error. 

• SDMAMLVL — module level information. 

• SDNARRL — IEAVETCR, recovery routine name. 


Variable Data 


Variable data in the SDNAVRA is recorded in the key-length-data 


format. 

A header contains RSLG in 

key-length-data format 

followed by the RSLG mapping in key* 
followss 

-length-data format as 

Offset 

RESUME data 

TCTL data 

X'OO' 

flag bytes Bit 0-0,RESUME 

flag byte> Bit 0=1,TCTL 

X'Ol' 

0 

SVTDACTV 

X'02* 

flag bytei Bit 0=1,lock obtained 
Bit 1=1,SRB obtained 

0 

X'04* 

PSASUPER 

PSASUPER 

X'08' 

PSACSTK 

PSACSTK 

X'OC' 

PSATOLD 

PSATOLD 

X'10* 

PSAAOLD 

PSAAOLD 

X* 14' 

input TCB address 

input TCB address 

X'18' 

input ASCB address 

SVTDSREQ 

X'lC* 

PSAHLHI 

ASCBSRQ 

X'20' 

home address space ID 

— 

X'22' 

0 

— 

X'24' 

ASCBTCBS 

— 

X'28' 

address of SRB, or 0 

— 


SUSPEND/RESUME/TCTL ERROR CONDITIONS 


The SUSPEND, RESUME, and TCTL macros issue the X*070' completion 
code when an error condition exists, and abnormally terminate 
the program issuing the macro. 

Refer to System Codes for a description of code X'070 1 and 
specific reason codes in register 15. 
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CONTROL BLOCK OVERVIEW 


Due to the complexity of the control block overview for 
Supervisor Control, it has been divided into two sections. 
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Figure 4 (Part 1 of 2). Control Block Overview 
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(See Part 1) 
(of Figure 8) 



Figure 4 (Part 2 of 2). Control Block Overview 
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PROCESS FLOW 


The module flows for Supervisor Control are included in this 
section. Each figure contains the calling module or routine* 
the modules called* and the exit for each specific module. 
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/• 




( Program Check ) 
\-/ 



IEAVEPCO/IEAVEPC 


Program check 

interruption 

handler 


Route control 
depending on the 
type of program 
check. 


To interrupted program 
(for monitor call, 
program event recording 
or page reclaim) 

or 

to dispatcher (IEAVEDSO) 
if SRB scheduled for PIE/ 
PICA processing or page 
exception requires I/O 

or 

to RTM for supervisor 
recovery. 



IEAVETIH 


Trace SLIH 
routine 


IEAVTPER 


Program FLIH/ 
SLIP interface 
routine 


IEAVESPI 


SPIE/ESPIE 

routine 


Generalized 

Trace 

Facility 


IARFP 


RSM module to 
process page or 
segment fault. 


IEAVTRTM 


CALLRTM 


Figure 5. Program Check Interruption Handlers 
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/-\ 

(SVC interruption) 
\-/ 



IEAVESVC 


SVC interruption 
handler 


error 


■> 


IEAVTRTM 


For requestors 
that cannot 
issue SVCs. 


<• 


> 


IEAVTEST 

TESTAUTH 


<■ 


> 


IEAVELK 


Spin lock 
manager 


<■ 


■> 


IEAVESLK 


Suspend lock 
manager 


V 


SVC routine 
or 

Extended SVC routine 


Figure 6. SVC Interruption Handler Process Flow 
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RESTART interruption (RESTART 

initiated via operator's console/ I- 

RESTART SIGP instruction) IEAVERO 

I i-> Restart FLIH 

|/^ DATOFF routine 





Figure 7. RESTART Interruption Handler Process Flow 
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/-\ 

(I/O interruption) 
\-/ 



IEAVEIO 


I/O interruption 
handler 


Accumulate 
processor wait 
time if coming 
from wait state. 

For interrupted 
TCB only. 


< 


> 


IOSVSLIH 
I/O supervisor 


V 


To interrupted program 
(if executing under SRB 
or if non-preemptive) 

or 

to dispatcher (IEAVEDSO) 
at one of the FLIH entry 
points. 


Figure 8. I/O Interruption Handler Process Flow 
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/-\ 

(External interruption) 
\-/ 



1EAVEEXT 


External 

interruption 

handler 


Accumulate 
processor wait 
time if coming 
out of wait 
state. 


- > 

or 

•<-> 

or 

•<-> 

or 

•<-> 

or 

•<-> 

or 

■<-> 


IEAVEXS 


External call 
(RPS6NL) 


1EAVEES 


Emergency signal 
(RIS6NL) 


IEAVRTIO 

(csect IEAOTIOO) 


Timer expired 


IGFPXMFA 


Malfunction 

alert 


IEEBC1PE 


Communication 
task caused 
interruption 


IEAVMFIH 


Service signal 
(X'2401*) 
interruptions 


To interrupted program 
(if executing under 
SRB, in a valid spin* 
interrupt was an EMS, or 
in non-preemptive mode) 

or 

to dispatcher at one 
of the FLIH entry points 


->See IPC module flows 


Figure 9. External Interruption Handler Process Flow 
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Emergency signal (RISGNL) 


/-\ 

(Request for signal) 

\-/ 

A 

| via RISGNL 
V 


IEAVERI 


Emergency signal 
processing 


A 

4 


IEAVESGP 
SIGP issuer 



External interruption 


IEAVEEXT 


External 
interruption 
handler (running 
on the signalled 
processor) 


A 

4 


IEAVEES 


Process the 
emergency signal 
(parallel or 
serial request). 


<• 


•> 


Routine specified 
by requestor. 


Figure 10. Interprocessor Communication (IPC) Remote Immediate Signal Process Flow 
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Emergency call (RPSGNL) 

/-\ 

( Request for call ) 

\-/ 

A 

| via RPSGNL 
V 



/I External interruption 


V 

IEAVEEXT 

External 
interruption 
handler (running 
on the signalled 
processor) 

A 

t 

IEAVEXS 

Process the 
external call. 


Depending on the <-: 

type of external 
call 9 invoke 
subroutines or 
process the 
SWITCH option 
inline. 



Figure 11. Interprocessor Communication (IPC) Remote Pendable Signal Process Flow 
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CALLER 


Issuer of CIRB 
macro. 

or 

Data management 
or supervisor 
routine. 


via CIRB 


BR 



IEAVEF00 



Stage 1 


✓ 


(Create IRB). 

-> 


SI 


I For CIRB entry 


For BR entry 


IEAVEEXP 


Exit Prolog 


<-IBR 


IEAVEEE2 


Stage 2 (Add 
IQE, RQE, or SRB 
to queue.) 


The dispatcher receives control following 
an interruption or a specific request for 
dispatching. See Dispatcher and Scheduler 
process flow in DISP. 


IEAVEDSO 


DISPATCHER 


Despatch the 
asynchronous 
exit. 


<• 


> 


IEAVEEEO 


Stage 3 

(Complete sched¬ 
uling of the 
asynchronous 
request)• 


For stage 3 recovery, 
see Supervisor Control 
Recovery Process Flow 


Si 

— -j_ 

Execute the 
asynchronous exit 

Figure 12. Exit Effectors for Asynchronous Exits Process Flow 
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PURGEDQ 
(cancel SRBs) 

/-\ 

( Issuer of PURGEDQ ) 

\-/ 

4 via PURGEDQ macro 


IEAVEPDO 


Invalid param¬ 
eters 


Unrecoverable 

error. 


/-\ 

>( ABEND ) 
\-/ 


<• 


■> 


IEAVESETS 


Stop SRBs. 
Start SRBs. 


<■ 


-> 


RMTR to clean up 
SRBs. Address 
of RMTR is in 
field SRBRMTR. 


IEAVTRT1 


IEAVEPDR 



See process 

■ ■ -> 

PURGEDQ 

<— 

“I 

flow 


recovery 

<1 

n 


/-\ 

( ABEND ) 
\-/ 


•> 


IEAVESCR 


SCHEDULE 

recovery 


■> 


IEAVSETS 


Start SRBs that 
have been stop¬ 
ped in the 
mainline. 


Figure 13. PURGEDQ Process Flow 
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/-\ 

( CALLER ) 
\-/ 


/| via a SETLOCK macro for a spin-type lock 


IEAVELK 


Obtaining a locks 

If the caller 
violates locking 
hierarchy. 

If the lock 
request is 
conditional and/ 
or the lock is 
obtained. 

If a spin lock 
cannot be 
obtained, check 
for ACR process¬ 
ing. 

If ACR condition 
exists 


If a spin lock 
cannot be 
obtained after 
an excessive 
amount of time, 
notify the 
operator. 


Releasing a locks 

If the lock is 
not held. 

Clear current 
locks held 
ownership bit. 

Set lockword to 
zero. 


ABEND X*073 f 


■> 


IEAVTRT1 


See process 
flow 


/-\ 

X CALLER ) 


\-✓ 


IEAVTRTM 


RTM 

module 


IEEVEXSN 


Excessive spin 

notification 

routine 


/-\ 

>C CALLER ) 


\-/ 


/-\ 

( CALLER ) 
\-/ 


Figure 14. Spin Lock Manager Process Flow 
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/-\ 

( CALLER ) 
S-/ 


/| via a SETLOCK macro for a suspend lock 


IEAVSLK 


Obtaining a locks 

If the caller 
violates locking 
hierarchy. 

If the lock 
request is 
conditional and/ 
or the lock is 
obtained. 

If a suspend lock 
cannot be obtain¬ 
ed, suspend the 
requestor on the 
lock's suspend 
queue. 


Releasing a locks 

If the caller 
violates locking 
hierarchy. 

If there is a 
pending STATUS 
request to stop 
a suspended CML 
requestor, mark 
that task non- 
dispatchable. 

Make the routines 
on the lock's 
suspend queue 
dispatchable. 


ABEND X'073* 


■> 


IEAVTRT1 


See process 
flow 


X CALLER ) 


IEAVESRT 


STOP/RESET 
service routine 


ABEND X'073' 


IEAVTRT1 


See process 
flow 


IEAVSETS 


(at IGC07904) 
STATUS routine 



IEAVESCO 


IEAVEMSO 

<-> 

SCHEDULE 

<-> 

Memory 


service routine 


switch 


/-\ 

( CALLER ) 
\-/ 


Figure 15. Suspend Lock Manager Process Flow 
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Repair routines 


Error in the 
supervisor routine 


IEAVTRT1 


Recovery termin¬ 
ation management 


IEAVESAR 


Supervisor 
analysis routine 


IEAVELCR 

Low storage 
> refresh routine 


IEAVELKR 


Spin lock 
repair routine 


IEAVELKR 


Spin lock 
repair routine 


IEAVEVRR 


ASVT/AFT 

verification/ 

reconstruction 

routine 


General recovery service routine 


IEAVESAR 


IEAVELKR 


IEAVEADV 

Supervisor 
analysis routine 

Spin lock 
repair routine 

Address 

verification 


FRR is on stack. 


Functional recovery 
-> routine for a super- - 
visor function 


Se< 
-fui 


See individual supervisor 
functions' recovery routines 


Figure 16 (Part 1 of 2). Supervisor Control Recovery Process Flow 
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FRR is last on 
super stack. 


No FRRs on stack. 


Depending on the 
type of recovery 
indicated# invoke 
appropriate 
recovery routine# 
via retry address 
specified by 
IEAVESPR. 



IEAVESPR 




See the Dispatcher 
process flow in DISP 



IEAVEPCR 


B 

Program check 
FLIH recovery 



X ABEND task that ) 
( issued SPIE ) 
\-/ 


Figure 16 (Part 2 of 2). Supervisor Control Recovery Process Flow 
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Executing on the signalling processor 


Enter ) 


A 


Executing on the signalled processor 


r 


IEAVEBBR 


Repeat the following 
loop for each online 
processor in the 
tightly coupled 
multiprocessing 
configuration* 

• Issue a serial 
RISGNL macro to 
the processor* 

• Spin until not¬ 
ified that the 
receiving routine 
has completed on 
the signalled 
processor. 

• If the bind break 
function was not 
successfully com¬ 
pleted* reissue 
the RISGNL macro 
to the same 
processor (repeat 
the loop). 


Receiving routine 
entry points 
IEAVEBB2 

Determine if the 
emergency signal 
occurred while the 
signalled processor 
was in a window 
spin. 


Emergency signal (EMS) 
external interrupt 

\- 


i—> 


IEAVEES 


Give control to 
the receiving 
routine speci¬ 
fied on the 
RISGNL macro. 

Reissue IEAVEBBR 
from it spin. 

Return to 
IEAVEEXT. 


<-J 


i 


IEAVEEXT 


Save (among other 
information cross 
memory control 
registers 3 and 4. 

Call IEAVEES to 
handle interrupt. 

Issue a CMSET RESET 
macro to force each 
processor to check 
if its cross memory 
environment is 
still valid* and to 
reload its cross 
memory control 
registers. 


( Exit to the ) 
(interrupted program) 
\-/ 


( Exit to Caller ) 
\-/ 


Figure 17. Bind Break Process Flow 
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METHOD OF OPERATION 


This section contains method of operation diagrams. The diagrams use 
either hipo format or prologue format. The following 
figure shows the symbols used in hipo format 
method-of-operation diagrams. 

The relative size and the order of fields in control block 
illustrations do not always represent the actual size and format 
of the control block. 


Kay to Symbols Used In Method-of-Operatlon Diagrams 



Primary processing - indicates major funtional flow. 



Secondary processing - indicates functional flow 
within a diagram. 



Data movement, modification, or use. 


Data reference — indicates the testing or reading 
of a data area to determine the 
course of subsequent processing. 


t 


Pointer — indicates that a data area contains the 
address of another data area. 


->. Indirect pointer — indicates intermediate pointers 

have been omitted. 


Connector - indicates that a diagram is 

continued on the next page. 



Figure 18. Symbols Used in Method of Operation Diagrams 
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The prologue format diagrams contain detailed information that is 
broken down into four different headings. The four headings and the 
topics they document ares 

Module Description, which includes! 

• Descriptive name 

• Function (of the entire module) 

• Entry point names, which includes! 

— Purpose (of the entry point) 

— Linkage 
— Callers 
— Input 
— Output 
— Exit normal 

- Exit error, if any 

• External references, which includes! 

— Routines 

— Data areas, if any 

- Control blocks 

• Tables 

• Serialization 

Note that brief module descriptions are also included in the 
last volume of the System Logic Library (which includes 
module descriptions for all modules described in the System 
Logic Library ). 

Module Operation, which includes! 

• Operation, which explains how the module performs its function. 

• Recovery operation, which explains how the module performs any 
recovery. 

Diagnostic aids, which provide information useful for 
debugging program problems; this includes! 

• Entry point names 

• Messages 

• Abend codes 

• Wait state codes 

• Return codes for each entry point. Within each entry point, returr 
codes might be further categorized by exit-normal and exit-error. 

• Entry register contents for each entry point 

• Exit register contents for each entry point 

Logic Diagram, which illustrates the processing of the 
module, the input it uses, the output it produces, and the flow of 
control. Some modules do not have a logic diagram because the 
processing is sufficiently explained in the module description, the 
module operation, and the diagnostic aids sections. The following 
illustrates the graphic symbols and format used in the logic diagrams. 
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LOGICKEY - Key to the Logic Diagrams 


STEP 01 


Callers 

c> 

LOGICKEY 


This paragraph describes what this nodule 
does. The sane text appears under the 
FUNCTION heading on the Module Description 
page. 


01 Numbered steps describe the 
1 — 1 processing at a high level. 

A. Lettered steps describe the processing 
at a lower level. 


SPQAADQE SPQAEDQEI 



1021 Input and output fields. 

The control block acronyn or data area naee 
appears above the input and output boxes* 
and the field nanes appear within the 
boxes. A dotted arrow eeans the data is 
referenced; a solid arrow neans the data is 
nodified. 


calls an external routine 
passing the parameter TR0B« 


ITRFBR 


kspqe 

/- 

SPQENEXT 
SPQESPQA 
SPQETCB 
SPQESPID 
SPQEKEY 
SPQESHR 
SPQEOWN 


SPQAFADQ 

SPQALADQ 

SPQAFEDQ 

SPQALEDQ 


Calls an internal subroutine 
Cat the step indicated) 
passing tuo parameters. 


passu 

/t—Kr 


SUBROUTN: 11 


EFMSS1 

TFWAPMSS 


EAECB 


EAERIMUT 


-> 05 issues a macro instruction 
K with these keywords# 

\/ parameters# and options. 


(EAERIMWT 

RCO) ASCBCTOBAASCB->ASCB) ERRETC CVTBRETI 


CVTBRET 



06 Branches to the internal 
— 1 label at the step indicated. 

I 1 >BRLABEL: 08 
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LOGXCKEY - Key to the Logie Diagrams STEP 07 



BR LABEL 


Callers 

Cr- 

PARAMETERS L —\/ 

-. S ECONDEP 

TR08 THISLINE j—. *-1 \ 

MAXUNES ETPBOPTS *-,/ 


TTE 


TTEMBZ1 


DO LABEL 
—-> 



issues an SVC. 


<__> 


SVC 


TSOTEST 


OS Step 06 branches here. Exits 
— J by issuing a program call 
(PC)* 


This is a secondary entry point* This 
paragraph describes the function of this 
entry point* Four parameters are passed 
an input* 


09 This is the beginning of an 
L — 1 iterative 00 group* 

A* Iterates this DO instruction at the 
specifed step number* 


B* Leaves this DO instruction and 
branches to the step indicated. 


10 Returns to the calling step 
— 1 outside of this module* 


09 

-j 


cn 
\ / 



SUBROUTN 


-1 

11 

This is an internal 
subroutine. 

This paragraph describes the function 
of this subroutine. 


121 Returns to the calling step 
— 1 within this module. 


ul 
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Diagram SUP-1. Address Verification (BEAVEADV) (Part 1 of 2) 


From supervisor 
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Diagram SUP-1. Address Verification (IEAVEADV) (Part 2 of 2) 

Extended Description Module 

1 The address verification routine checks the SDWA IEAVEADV 

f lags for Indication of a storage check error. If a 

storage check did not occur processing continues at step 4. 

2 The error range validity is checked via the SDWA 
flags. If it is not valid, processing continues at 

step 4. 

3 A check is made to see if the input storage range 
intersects with the storage error range indicated in 

the SDWA. If so, return Is to the caller with a code of 

8 in register 15. 

4 The final test is to check if the indicated storage Is 
in real storage by doing an LRA on the beginning 

and ending addresses. If not in storage, a return code of 

4 is returned to the caller In register 15. If it is in storage, 

a return code of 0 is returned to the caller. 


Label 
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Diagram SUP-2. Bind Break Service Routine (DEAVEBBR) (Part 1 of 6) 


Input 


Register 0 


function 

code 


CDS 


Called by a module that has 
changed the cross memory 
environment of an address space 

Process 


Register 1 


i i amd i 

16 31 


CSDCPUAL 


CSDCPUOL 


CSDMASK 






3 


*1 If requested, mark a specified 
address space invalid for cross 
memory access. 


• If the input ASID is not 


• If the function code is 
invalid 


2 Determine if there are any 
online processors in the 
system other than this one. 


• If not 





Output 



Return 
to caller 


ASCB associated with the input 
ASID 



Register 15 
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Register 15 
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Register 16 
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Diagram SUP-2. Bind Break Service Routine (IEAVEBBR) (Part 2 of 6) 


Extended Description 

Module 

Label 

Extended Description 

Module 

The bind break module (IEAVEBBR) is called in two 
situations: 

• When a module changes the cross memory environ- 



2 If the current system configuration includes only one 
online processor, there are no binds to break and 
lEAVEBBR's work is finished. IEAVEBBR sets a return 
code of zero and returns to the caller. 



ment (the AX, LX, or LT) of an address space, it calls 
IEAVEBBR to determine if the change made the 
cross memory environment of any tightly-coupled 
online processor invalid. If It did, the unit of work 
on that processor is abended. If a processor's cross 
memory environment is still valid, IEAVEBBR ensures 
that the processor's cross memory control registers 
contain current information. 

• When an address space can no longer be accessed 
using cross memory instructions, or when an address 
space that can be accessed in cross memory mode 
is being terminated, the module handling the situation 
calls IEAVEBBR to set the address space's invalid- 
for-cross-memory-access (ASTEICMA) flag, and to 
break all active binds to the address space. If any 
tightly-coupled online processor's primary or secondary 
address space is the same as the address space that is 
no longer accessible, the unit of work on that processor 
is abended. 

At entry, register 0 contains a function code indicating 
which of the above functions IEAVEBBR is to perform. 

If the ASTEICMA flag is to be set, register 1 specifies the 
target ASID. 

1 If the function code is 4, IEAVEBBR sets to one the 
ASTEICMA flag associated with the address space 
identified in register 1. To locate the specified ASCB, 
IEAVEBBR calls IEAVECMS at entry point IEAVLACB. 

If IEAVLACB determines that the specified ASID is not 
assigned, IEAVEBBR sets a return code of 8 and returns 
to the caller. 

If the function code is invalid (neither 0 nor 4) 

IEAVEBBR sets a return code of 4 and returns to the 
caller. 


Label 
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Diagram SUP-2. Bind beak Service Routine (IEAVEBBR) (Part 3 of 6) 
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Diagram SUP-2. Bind Break Service Routine (IEAVEBBR) (Part 4 of 6) 

Extended Description Module Label 

3 .IEAVEBBR ensures that every tightly-coupled online 
processor checks whether its cross memory environment 
is still valid after the change, and, if necessary, updates Its 
cross memory control registers to reflect the change. To 
do this, IEAVEBBR issues a RISGNL SERIAL macro to 
each online processor except the one on which it is exe¬ 
cuting. The macro triggers the following sequence of 
events. See the Bind Break Module Flow figure for a 
picture of these events. 

• An external interrupt occurs on the signalled 
processor. 

• IEAVEBBR enters a spin loop on the signalling 
processor, and loops until the interrupt handler clears 
the PCCAEMSI word indicating that the receiving 
routine has completed on the signalled processor. 

• The external interrupt FLIH (IEAVEEXT) gets 
control on the signalled processor and saves the 
processor's control registers 3 and 4 (the primary 
and secondary ASIDs and the AX value) in the PSA. 

• Because this is an emergency signal (EMS) interrupt, 

IEAVEEXT gives control to the emergency signal 
SLIH (IEAVEES), which gives control to the RISGNL 
receiving routine (IEAVEBB2 in, IEAVEBBR). 

• IEAVEBB2 determines whether the EMS interrupt 
occurred while the signalled processor was in a 
window spin, and sets the LCCABBRC field in the 
signalling processor's LCCA accordingly. IEAVEBBR 
uses this field later to determine whether the bind 
break function was completed successfully. (Binds 
cannot be broken when the signalled processor is In 

a window spin.) 

• When the signalled processor is not in a window spin, 

IEAVEBB2 also issues a precautionary CMSET SET 
macro, which sets the primary and secondary ASID 
to the home ASID. The CMSET SET macro is neces¬ 
sary because IEAVEES informs the signalling proces¬ 
sor to resume executing before it returns control to 
IEAVEEXT, which then performs the bind break 
function. The CMSET macro ensures that the signal¬ 
ling processor's cross memory environment is valid 
between now and the time IEAVEEXT actually 
performs the bind break operation. 


Extended Description 
3 (continued) 


Module 


Label 


• IEAVEBB2 returns to IEAVEES, which releases the 
signalling processor from its spin by clearing the 
PCCAEMSI word in the signalling processor's PCCA. 
IEAVEES then returns to IEAVEEXT. Thus, 
IEAVEBBR resumes executing on the signalling 
processor while IEAVEEXT completes the bind break 
function on the signalled processor. The next step 
(step 4) describes what IEAVEBBR does when it 
resumes executing. The next bullets describe how 
IEAVEEXT completes the bind break function. 

• If the signalled processor was in e window spin when 
the interrupt occurred, IEAVEEXT returns to the 
interrupted program. It cannot complete the bind 
break function. 

• If the signalled processor was not in a window spin 
when the interrupt occurred, IEAVEEXT issues a 
CMSET RESET,CHKAUTH=(YES) macro. The 
CMSET service routine (IEAVECMS) first checks 
whether the signalled processor's primary and second¬ 
ary ASIDs can still be accessed using cross memory 
instructions, and whether they can access each other. 

If they can, IEAVECMS reloads the signalled proces¬ 
sor's cross memory control registers. This ensures 
that, if applicable, the signalled processor picks up 
the cross memory change that triggered the call to 
IEAVEBBR. Note that the CMSET RESET is done 
on all eligible online processors, even though the 
processor might not have an active bind to the address 
space whose cross memory environment changed 
(neither its primary nor secondary address space is 
the same as the changed address space). In this 
instance, the CMSET RESET macro resets, but does 
not change, the control register values. 

If the processor's cross memory environment is not 
valid after the change, IEAVECMS terminates the unit 
of work in progress by issuing ABEND X'058' with 
the appropriate reason code. 

• IEAVEEXT returns to the interrupted unit of work. 
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Diagram SUP-2. Bind Break Service Routine (IEAVEBBR) (Part 5 of 6) 
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4 Determine whether the bind break 
function completed successfully. 


• If not, repeat step 3 on the 
same processor. 


5 Determine if any processors remain 
to be signalled. 


• If so, repeat step 3 on the next 
processor. 


• If not, set a return code of zero. 


Entry point IEAVEBB2 (the receiving 
routine that gets control on the signalled 
processor after the mainline signals the 
processor): 


£ 


6 Determine if the signal interrupt 
occurred while the signalled processor 
was in a window spin. 


£ 


Output 




Step 3 



Return 
to caller 


$ 


Register 15 




Caller 
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Signalling processor's LCCA 
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Diagram SUP-2. Bind Break Service Routine (IEAVEBBR) (Part 6 of 6) 

Extended Description Module Label 

4 IEAVEBBR checks the LCCABBRC field to determine 
whether the interrupt occurred while the signalled 

processor was in a window spin. If it did not, IEAVEBBR 
assumes that the bind break function completed suc¬ 
cessfully and continues processing at the next step. 

If the signalled processor was in a window spin, 

IEAVEBBR adds one to the number of unsuccessful 
signal attempts and reissues the RISGNL macro to the 
same processor. When the number of attempts made 
exceeds a specified limit, IEAVEBBR calls the excessive 
spin notification routine (IEEVEXSN) to issue message 
IEE331A. IEAVEBBR then resets the spin count and 
continues signalling the processor. 

5 IEAVEBBR looks for another online processor to 
signal. If there is one, IEAVEBBR repeats step 3 

for that processor. After all the online processors have 
been signalled, IEAVEBBR sets a return code of zero and 
returns to the caller. 

Q IEAVEBB2's processing is described in step 3. 

Recovery Procesring: 

IEAVEBBR does not establish its own recovery envir¬ 
onment. If an error occurs while IEAVEBBR is execu¬ 
ting, the caller's recovery routine receives control. 
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Diagram SUP-3. Control Block Verification Routine (IEAVECBV) (Part 1 of 10) 
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Verify the ASCB storage is 
referenceable. 
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• Invalid. 
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When the ASID is not zero, verify that 
the input ASCB address matches the 
address found by indexing into the ASVT. 


Invalid. 


■II 


4 When the ASID is zero the input 

address must match the address of "WAIT 
ASCB". 


• No match. 


5 Verify that the ASCB contains a 
valid acronym. 



• Invalid. 


Output 


IEAVEAOV 


Verify 

address 
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To caller 
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Diagram SUP-3. Control Block Verification Routine (1EAVECBV) (Part 2 of 10) 

Extended Description Module Label 

This module will determine whether an Input address is 
the address of a valid 1) current ASCB, 2) general ASCB, 

3) SRB, 4) TCB, or 5) STCB. 

1. 5 . For current ASCB verification (IEAVECAS), 

the input address must pass the following 

criteria: 

• Addressable potential ASCB storage. 

• ASID < maximum. 

• When the ASID * 0, the input address matches the 
address found by indexing into the ASVT. 

• When the ASID 3 0, the input address must match 
the address of “WAIT ASCB". 

o Valid acronym (ASCB). 

• Addressable and valid SRB address on SPL. 

• Addressable ASXB. 

• ASXB must have a valid acronym, an addressable IHSA, 
and an addressable local work/save area vector table. 

A return code of 0 indicates a valid control block. 

A return code of 4 Indicates a control block contains 
bad information. 

A return code of 8 indicates not a control block. 
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Diagram Sl/P-3. Control Block Verification Routine (IEAVECBV) (Pert 3 of 10) 

_ Process 

6 Verify that the SRB on the SPL 
ii addressable 

• Not addressable. 

7 Verify that the ASXB is 
addressable. 

• Not addressable. 

g Verify that the ASXB contains 
valid acronym. 

• Invalid. 


9 Verify that the IHSA is 
addressable. 

• Not addressable. 
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Output 



Register 15 
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Register 15 
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Register 15 
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Diagram SUP-3. Control Block Verification Routine (IEAVECBV) (Part 4 of 10) 

Extended Description Module Label 

6-9 For current ASCB verification (IEAVECAS), 
the input address must pass the following 

criteria: 

• Addressable potential ASCB storage. 

• ASID < maximum. 

• When the ASID * 0. the input address matches the 
address found by indexing into the ASVT. 

• When the ASID *■ 0, the input address must match the 
address of "WAIT ASCB". 

• Valid acronym I ASCB). 

• Addressable and valid SRB address on SPL. 

• Addressable ASXB. 

• ASXB must have a valid acronym, an addressable IHSA, 
and an addressable local work/save area vector table. 

A return code of 0 Indicates a valid control block. 

A return code of 4 indicates a control block contains 
bad Information. 

A return code of 8 indicates not a control block. 
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Diagram SUP-3. Control Block Verification Routine (IEAVECBV) (Part 6 of 10) 

Extended Description Module Label 

10 ASXB must have a referenceable local work/save 
area vector table. 

A return code of 0 indicates a valid control block. 

A return code of 4 indicates a control block contains 
bad information. 

11-13 F° r general ASCB verification (IEAVEGAS), 
the input address must pass the first six 
criteria listed under the current ASCB verification. The 
return codes indicate the same conditions. 
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Diagram SUP-3. Control Block Verification Routine (IEAVECBV) (Part 8 of 10) 

Extended Description Module Label 

14-17 For SRB verification, the following criteria 
must be met: 

• Referenceable SRB storage. 

• Valid ASCB pointer. 

• Valid save area data. 

• When the save area address f 0, the address of the 
resource manager routine must be that of the resource 
manager for suspended SRB's. 

• When the save address ° 0, the routine entry point 
address must be non-zero. 

Return codes indicate the same conditions as indicated 

under current ASCB verification. 
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Diagram SUP-3. Control Block Verification Routine (IEAVECBV) (Part 9 of 10) 


Input 


Process 
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IEAVETCB ENTRY: 
TCB Verification 


18 Verify that theTCB address is 
referenceable. 

• Not referenceable. 


19 Verify that the last 4 bits of the 
storage protect key are zero. 

• Not zero. 


20 Verify a valid TCB acronym. 
• Invalid. 


ti 


IEAVEADV 


Verify 

address 


5 


To caller 


5 


To caller 


21 Verify that the AOS/2 common extension 
pointer is valid and that the RB is in fixed 
storage. 


Any failure. 


22 Verify that the STCB pointer 
is valid and that the STCB is 
referenceable and has a valid 
acronym. 

e Any failure 




To caller 


Output 
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Register 16 


Return 8 


Register 16 


Return 8 


Register 16 
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Register 16 


Register 15 
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Diagram SUP-3. Control Block Verification Routine (IEAVECBV) (Rut 10 of 10) 

Extended Deteription Module Lebel 

18-22 For TCB verification, the following criteria 
must be met: 

• Referenceable potential TCB storage. 

• Last 4 bits of the storage protect key must be zero. 

• Valid acronym. 

• Valid AOS/2 common extension pointer. 

• Current RB in fixed storage. 

• Valid STCB must exit. 

Return codes are the same as for the current ASCB 
verification routine. 


"Restricted Materials of IBM" 
Licensed Materials “ Property of IBM 



SUP-68 MVS/XA 


Diagram S.lfP-4. CMSET, LOCASCB,.and CALLDISP Macro Service Routine (IEA VECMS) (Part 1 of 8) 

Branched to 
from the 
CMSET SET 




Cross memory 
control registers 
























LY28-1765-0 (c) Copyright IBM Corp. 1987 Method of Operation SUP-69 


Diagram SUP-4. CMSET, LOCASCB, and CALLDISP Macro Service Routine (IEAVECMS) (Part 2 of 8) 


Extended Description Modulo Label 

When any of the following macros Is issued, IEAVECMS 
receives control to perform the requested service. 

o CMSET SET 

• CMSET RESET with authorization checking 

• CMSET RESET without authorization checking 

• CMSET SSARTO 

• CMSET SSARBACK 

• LOCASCB 

• CALLDISP (specifying the BRANCH a YES option). 

Each macro has its own entry point and is described sepa¬ 
rately in this diagram. 

CMSET SET processing: 

The CMSET SET service routine establishes an input ASCB 
as both the caller's primary and secondary address space. 

The caller specifies whether IEAVECMS is to perform the 
service unconditionally or only when the input ASCB can 
be accessed In cron memory mode. 

1 If the caller provided a cron memory save area, IEAVECMS IEAVCMS1 

IEAVECMS saves current cron memory control regis¬ 
ters 3 and 4 in the caller's save area. 

2 If the caller requested that IEAVECMS perform the 
service only if the input ASCB can be accessed in cron 

memory mode, IEAVECMS checks the invalid-for-cron- 
nrtemory-occess indicator (the ASTEICMA field) in the 
input ASCB's ASTE. If it is set to 1, IEAVECMS sets a 
return code of 4 and returns to the caller. 

If the input ASCB address is not a valid ASCB, IEAVECMS 
issues an ABEND with an X'058' completion code and an 
X'28' reason code in register IS. 


Extended Description Module 

e Loads the ASID of the specified address space into 
control register 3. This establishes it as the secondary 
ASID. In the process, the PSW key-mask contained 
in the high order bits of control register 3 is set to zero* 

• Loads the ASID of the specified address space and the 
caller's authorization index (AX) Into control register 4. 

This sets the new PASID and AX. 

• Loads the caller's linkage table designator (LTD) into 
control register 6, primary segment table designator 
(STD) into control register 1, and secondary STD into 
control register 7. 

IEAVECMS returns to the caller with a return code of 0. 

This indicates that the specified address space is now the 

PASID and SASID. 


3 When the request can be performed, IEAVECMS 
establishes primary and secondary addressability to 
the specified ASCB by changing the processor's cross mem¬ 
ory control registers. To do this, IEAVECMS: 


Label 
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Diagram SUP-4. CMSET, LOCASCB, and CALLDISP Macro Service Reoutine (IEAVECMS) (Part 3 of 8) 
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4 Determine If the Input 
primary and secondary 
address spaces can be 
accessed using cross 
memory instructions, and 
are authorized to reference 
each other. 


9 If not 


5 Restore the previously 
existing cross memory 
state. 


Entry point: IEAVCMR2 
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state if primary and 
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Diagram SUP-4. CMSET, LOCASCB, and CALLDISP Macro Service Routine (IEAVECMS) (Part 4 of 8) 


Extended Datcription Module 

4 

CMSET RESET prooasring: 

The CMSET RESET service routine restores a previously 
existing cross memory environment At entry, register 0 
points to a save area containing the cross memory status to 
be restored. 

4 When the caller specified the CHKAUTH-YES 
option, IEAVECMS determines if the input primary 

end secondary address spaces meet the following conditions: 

q Both address spaces can currently be accessed in cross 
memory mode 

a The job step task in neither address space has termi¬ 
nated 

a Both ASIDs are assigned 

a The address spaces ere authorized to reference each 
other 

If 8ny of these conditions Is not satisfied, IEAVECMS 
issues ABEND X < 058* with a unique reason code. (See Sys¬ 
tem Mesupas and System Cod» for tlw specific reason • 
codes.) 

5 When the processor's cross memory environment can 
be restored, IEAVECMS loads: 

a The primary segment table designator (STD) into con¬ 
trol register 1 

a The secondary ASID Into control register 3 

a The primary ASID and authorization index into control 
register 4 

a The linkage table designator into control register 6 
a The secondary STD into control register 7 

0 When the CMSET RESET macro is issued and no 
authorization check is requested, IEAVECMS restores 
the previously existing cross memory environment as de¬ 
scribed in step 5 if the input primary and secondary address 
spaces are currently assigned. If the address spaces do 
not exist, IEAVECMS issues ABEND X*058* with a unique 
reason code. (See System Messages and System Codes for 
the specific reason codes.) 


Label 


IEAVCMR1 


IEAVCMR2 
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Diagram SUP-4. CMSET, LOCASCB, and CALLDISP Macro Service Routine (IEAVECMS) (Part 5 of 8) 
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contains a currently 
valid secondary ASID, 
reset the secondary 
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Diagram SLIP-4. CMSET, LOCASCB. and CALLDISP Macro Service Routine (IEA VECMS) (Part 6 of 8) 

Extended Description Module Label Extended Description Module Label 


CMSET SSARTO processing: 

The CMSET SSARTO service routine unconditionally estab- IEAVCMST 

lishes the input address space as the secondary address 

space and puts the caller into secondary addressing mode. 

As a result, the caller executes in secondary mode and 

accesses data in the secondary address space. 

7 To establish secondary addressability to the input 
address space, IEAVECMS: 

• Checks the validity of the input ASCB address. If the address 
is not valid, IEAVECMS issues an ABEND with an X '058' 
completion code and an X '34' reason code in register 15. 

• Saves in register 1 a token containing the current SASID 
and PSW S-bit. IEAVECMS returns this token to the 
caller. The caller uses it when issuing a CMSET 
SSARBACK macro, which restores the cross memory 
environment to its state prior to executing this macro. 

• Loads the new SASID into control register 3. 

• Puts an authorization index (AX) of 1 into control 
register 4, which authorizes the caller to access any 
address space in secondary mode. 

• Loads the new SASI D's segment table designator (STD) 
into control register 7. 

• Sets the S-bit inthe PSW, which puts the processor in 
secondary addressing mode. 

• When cross memory hardware is being simulated, loads 
control register 1 with the SASI D's STD. 

• Returns to the caller. 


8 To restore the cross memory environment, 

IEAVECMS: 

• Verifies that the input SASI D contained in the token is 
currently assigned. If the input SASID is not currently , 
assigned, IEAVECMS issues an X'38' reason code in 
register 15. 

a Puts the input SASID into control register 3 

• Puts the PASID's authorization index (AX) into control 
register 4 

• Puts the SASID's STD into control register 7 

• Restores the previous addressing mode by adjusting the 
PSW S-bit 

• Returns to the caller 
LOCASCB processing: 

The LOCASCB macro service routine locates and returns 
the address of the ASCB associated with the ASID specified 
in register 1. 

9 If the input ASID is assigned, IEAVECMS returns the IEAVLACB 

associated ASCB's address in register 1. If the ASID is 

not assigned, IEAVECMS returns a zero or negative value in 
register 1. 


CMSET SSARBACK processing: 

The CMSET SSARBACK service routine restores the IE AVCMSB 

secondary ASID and cross memory addressing mode that 
existed before the CMSET SSARTO macro was executed. 

IEAVECMS receives as input the token it returned to the 
caller after processing the CMSET SSARTO macro. The 
token contains the SASID and PSW S-bit values that are to 
be restored. 
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Diagram SUP-4. CMSET, LOCASCB.and CALLDISP Macro Service Routine (IEAVECMS) (Part 7 of 8) 
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10 Disable the processor for 
external and I/O inter¬ 
rupts. 


Register 0 _ 

0-do not save the FRR stack 
4-save the FRR stack 



Entry point: IEAVCDDS for 
disabled callers 

11 Determine if the request 
can be processed. 


• If not 


Register 1 PSA 

PSATOLD 


PSASUPER 


PSALOCAL 


PSAHLHI 


PSACSTK 

PSANSTK 



a 


12 Save the caller's status, 
release the CMS or local 
lock (if held), and free 
the FRR stack (if 
requested). 


13 Branch to the dispatcher. 



Dispatcher 


LCCA 


LCCACDXM (4 cross- 
memory save area) 


Output 




4 


ABEND X'OSP 


Register 15 
Reason code 


TCB 


TCBRBP 


-aRB 

fF 


TCBGRSO 


TCBGRS1 


TCBGRS16 


A TCBXSB 
UXSB_ 


RBOPSW 


PSA 


PSALOCAL 


PSAHLHI 


XSBXMCRS 
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Diagram SUP-4. CMSET, LOCASCB, and CALUHSP Macro Service Routine (IEAVECMS) (Part 8 of 8) 

Extmdad Description Module UM 

CALtDtSP preceding: 

The CALLDI8P nrvlci routine provides • means for key 0, 
supervisor stats, task mode routines to eive up control end 
enter the dfepctcher. 

10 If the caller is enabled, IEAVECMS disables the pro- IEAVCOEN 

cessor for external and I/O interrupts and saves register 

144 in the PSA. 

11 To determine if the request can be processed, IEAVCODS 

IEAVECMS checks the following conditions in the 

order specified. If e condition is not met, IEAVECMS issues 
ABEND X*oar with e unique reason code. (See System 
M e s s a g e s end System Codes for the specific reason codes.) 

• The caller is in TCB mode 

• Register 1 contains a zero 

• No super bits are set (PSASUPER-0) 

• Register 0 contains a 0 or a 4 

• The normal FRR stack is the current one 

• If the FRR stack is not being saved, RTM1 is not active 

• If the FRR stack is not being saved, only the CML or 
LOCAL lock is held. Note that no locks are required. 

• If the FRR is being saved and the LOCAL or CML lock 
is held then an EUTFRR must exist 

• If the FRR stack is being saved, no locks can be held 
except as stated above. 

12 In preparation for branching to the dbpatcher, 

IEAVECMS: 

• Saves the caller's registers in the TCB. 

• Saves the caller's cross memory registers in the TCB's 
XSB. 

• Saves the caller's resume PSW in the RB. 

• If the cellar holds the LOCAL or CML lock, frees It. 

• If the cellar requests it, frees the FRR stack. Otherwfee, 
the dispatcher later decides whether to free the FRR 
stack. 

13 IEAVECMS branches to the dispatcher at entry point 
IEAODS1. 
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Diagram SUP-5. Inter processor Communication (IPC) Direct Signal Routine (IEAVEDR) (Part 1 of 2) 
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Diagram SUP-5. Interprocessor Communication (1PC) Direct Signal Routine (IEAVEDR) (Part 2 of 2) 


Extended Description Module Label 

IEAVEDR provides the user with the necessary 
interfaces and facilities to signal another online 
processor via the SIGP hardware instruction. The 
SIGP instruction allows the user to invoke a 
specific hardware function on the signalled processor. 

1 Saves the caller's registers in the SCWA. Save the 
system mask in PSAIPCSM. 

2 Validates the order code. If the order code is not 
valid, issues an X'07B' ABEND and a reason code 

of X '14'. 

3 Validates the PCCA address. If the PCCA address 
Is invalid, issues an X'07B', ABEND and a reason 

code of X '08'. If the PCCA address is valid, extracts 
the physical processor ID to be signalled from the PCCA 
in anticipation of calling the SIGP service routine (entry 
point IEAVSIGP*in module IEAVESGP). 

4 Gails IEAVESGP to issue the SIGP instruction. 

5 Checks the return code from IEAVESGP. If the IEAVEDR 

return code is X 'OB', status has been returned to 

register 0 and IEAVEDR copies the status information 
into register 1. 

6 Returns to the caller after restoring the original 
system mask and registers. 


IEAVEDR 

IEAVEDR 

IEAVESGP IEAVSIGP 
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Diagram SUP-6. Stage 3 Exit Effector (IEAVEEEO) (Part 1 of 6) 


Branch from the 
dispatcher to complete the 


scheduling of an 
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Step 4 


Step 4 
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Diagram SUP-6. Stage 3 Exit Effector (IEAVEEEO) (Part 2 of 6) 

Extended Description Module Label 

The stage 3 exit effector (the last routine used to schedule 
an asynchronous exit), dequeues IQEs (interruption queue 
elements), RQEs (request queue elements) or SRBs 
(service request blocks) from asynchronous exit queues 
pointed to by the ASCB. For each element removed, it 
initializes and chains to the TCB an IRB/XSB or SIRS/ 

XSB pair. The dispatcher enters the stage 3 exit effector 
as a subroutine. 

1 Supervisor services use IQEs as a general interface for IEAVEEEO 
requesting scheduling of an asynchronous routine. 

For each IQE on the asynchronous exit queue, the stage 
3 exit effector does the following: 

• Determines if the IQE can be dequeued at this time. 

An IQE cannot be dequeued if: 

a. The IQE has been purged by DUMP (IQEPURGE»1). 

b. The IRB (interruption request block) is already be* 
ing used (RBFACTV**!). 

c. The task that the asynchronous exit is to process 
is executing on another processor or holds a lock. 

d. The asynchronous exit is being scheduled to the 
error task and an error recovery procedure is exe¬ 
cuting on th8t task. 

e. Asynchronous exits have been suppressed for the 
intended task (TCBFX-1). 

f. The IQE is for an attention exit and either all 
asynchronous exits or attention exits are sup¬ 
pressed (TCBFX=1 or, TCBATT«t) for the in¬ 
tended task or one of the task's descendants in the 
task tree. 

g. The resume or transfer control function is execut¬ 
ing for the TCB that the stage 3 exit effector is 
checking (TCBS3A»1 and TCBACTIV«1). The stage 
3 exit effector turns on the flags. 

h. The TCB has any enabled, unlocked task (EUT) 
mode FRRs (TCBNSSPft)). 

i. The vector facility environment is being 
established for the task, and an SRB has been 
scheduled to complete the environment 
(STCBPIQ=1). 

• If the IQE can be dequeued and the IRB is for an 
attention exit, the stage 3 exit effector (IEAVEEEO) 
turns off the TCBTIOTG flag (which exit prolog sets 
to ensure that TGET/TPUT SVRBs are purged), if 
the TCBS3MR flag is set (making the task non-dis- 
patchable until the attention exit executes), 

IEAVEEEO turns off the flag and adds one to the 
ready TCBs count (ASCBTCBs). 

• For each IQE that can be dequeued, IEAVEEEO 
removes it from the queue and chains the speci¬ 
fied IRB to the TCB, as described in step 4. 


Extended Description 


Module 


Label 


2 Data management uses RQEs as a special interface in 
scheduling an asynchronous exit. 

• For each RQE on the asynchronous exit queue, a 
series of tests are made to determine if it can be de¬ 
queued at this time. An RQE cannot be dequeued if: 

a. Asynchronous exits are suppressed for the task 
(TCBFX-1). 

b. The task it is being scheduled to is active an on- 
other processor or holds a lock. 

c. The IRB Is already in use (RBFACTV°1). 

d. The asynchronous exit is being scheduled to the 
address space's error task and an error recovery' 
procedure is already executing on the error task. 

e. The resume or transfer control function is excut- 
ing for the TCB that the stage 3 exit effector is 
checking (TCBS3A-1 and TCBACTIV-1). The 
stage 3 exit effector turns on the flags. 

f. The TCB has any EUT mode FRRs (TCBNSSP#)). 

g. The vector facility environment is being established 
for the task, and an SRB has been scheduled to cpmp 
complete the environment (STCBPIQ=1). 

• For those RQEs that can be dequeued, IEAVEEEO 
removes the RQE from the queue and chains the 
specified IRB to the TCB, as described In step 4. 

3 SRBs on the queue represent requests by IOS to 
schedule non-resident error recovery procedures. 

There is a single system IRB per address space that runs 
only under the error task of the address space. The stage 
3 exit effector tries to schedule this SIRB for only the top 
SRB on the queue. 

The SIRB cannot be scheduled if: 

• The error task is already executing on another pro¬ 
cessor or holds a lock. 

• An error recovery procedure is already executing in 
the address space. 

• The resume or transfer control function is executing 
for the error task (TCBS3A°1 and TCBACTIV»1). 

The stage 3 exit effector turns on the flags. 

• The error task has any EUT mode FRRs 
(TCBNSSP*0). 

If the error task can be scheduled, IEAVEEEO dequeues 
the top SRB and chains the SIRB to the error task, as 
described in step 4. 

• The error task has any EUT mode FRRs 
(TCBNSSP=0). 

• The vector facility environment is being established 
for the task, and an SRB has been scheduled to 
complete the environment (STCBPIQ=1). 
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Diagram SUP-6. Stage 3 Exit Effector (IEAVEEEO) (Part 4 of 6) 

Extended Description Module Label 

4 In order to schedule the asynchronous routine, the 
stage 3 exit effector: 

• Gets an XSB when preparing an IRB for scheduling. 

(Every RB on the TCB/RB queue must have an 
XSB; an SIRB already has one). If an XSB from 

a previous IRB is available (ASXBXSBAtO), 

IEAVEEEO uses It. Otherwise, it gets storage for a new 
one. 

• Initializes the XSB for non-cross memory mode exe¬ 
cution (the primary and secondary ASIOs equal the 
home ASID). 

• Uses the PSW and TCB keys to form the key mask 
in the XSB. 

• Places the IRB on the RB chain of the specified task. 

The IRB becomes the current RB for that task. 

• Updates the TCBXSB field to point to the new top 
RB's XSB. 

e Marks the IRB active (RBFACTV=1) so that any 
other requests for use of the same IRB will be defer¬ 
red. 

• Moves the saved registers of the previously current 
routine from the TCB to the IRB general register 
save area. 

• Sets the address portion of the RBOPSW to the ad¬ 
dress specified in the RBEP field. This ensures that 
the dispatcher gives control to the asynchronous 
routine at the specified entry point. 

• If the ASCBPER bit is on, turns on the PER bit 
in the RBOPSW. 

• Sets the RBIQE to point to the queue element that 
scheduled the asynchronous routine (IQE, RQE, or 
SRB) so that the asynchronous exit gets control 
with specific register contents. 

• If the task is ready but previously was not, increases 
the count of ready TCBs (ASCBTCBS) by one, updates 
the TCB ready pointer (ASCBTNEW) if the task is of 
higher priority than the current ASCBTNEW, and calls 
Memory Switch (at entry point IEAVEMS5) to check 
for a processor in a wait to pick up the task. 
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Diagram SUP-6. Stage 3 Exit Effector (IEAVEEEO) (Part 5 of 6) 
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Diagram SUP-6. Stage 3 Exit Effector (ESAVEEEO) (Part 6 of 6) 

Extended Description Module Label 

5 The stage 3 exit effector recovery routine verifies and IEAVEEER IEAVEEEF 
corrects the exit effector queues (which consist of an 
IQE queue, an ROE queue, an SRB queue and an XSB 
queue). It uses the queue verifier (IEAVEQVO) to per¬ 
form this verification. It calls the routine once for each 
queue. After each call, it will store a word of zeros in¬ 
to the recording area to delimit the end of the recorded 
output The verification of each queue element is per¬ 
formed as follows: 

• For an IQE, the address verification routine ensures 
that the IQE address, the TCB address contained in 
the IQE, and the IRB address contained in the IQE, 
are ail referenceable. 

• For an ROE, verification includes ensuring that 
the RQE storage* and the IRB and TCB storage 
pointed to by RQERRQand RQETCB are all refer¬ 
enceable. 

• For an SRB, verification ensures that the SRB storage 
is referenceable. 

• For an XSB, verification ensures that the XSB stor¬ 
age can be referenced. 
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Diagram SUP-7. Stage 2 Exit Effector (IEAVEEE2) (Part 1 of 2) 


Input 


From supervisor and 
data management routines 
to perform the second 
step in scheduling an 
asynchronous exit routine 


Process 


Output 


IEA0EF00 


1 The calling routine has built on 
an IQE. RQE, or SRB. Queue It 
on the appropriate exit queue. 


2 Set the stage 3 switch for the 
dispatcher and the stage 2 
switch for SETLOCK. 

3 Call memory switch to update 
PSAANEW. 


e For IRBs and RQEs 





Address of IQE. SRB or RQE In 
true form 


|QE on A8XBFIQE 
RQE on ASXBFRQE 
SRB on ASXBFSRB 
(See stage 3 exit effector for 
the queue structure! 
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Diagram SUP-7. Stage 2 Exit Effector (IEAVEEE2) (Part 2 of 2) 

Extended Description Module Label 

<1 The exit queue on which the stage 2 exit effector IEAVEEE2 IEAOEFOO 

places the input queue element depends on whether 
the queue element is an IQE (interruption queue element), 
an RQE (request queue element), or an SRB (service request 
block). 


Type of 
Queue 


Type of 

Exit 

Element 

Purpose 

Queue 

IQE 

Supervisor routine wants to 
schedule an asynchronous 
exit routine. 

ASXBFIQE 

ASXBLIQE 

RQE 

Data management routine 
wants to schedule an 
asynchronous routine. 

ASXBFRQE 

ASXBLRQE 

SRB 

I/O supervisor wants to 
schedule an error recovery 
procedure (ERP). 

ASXBFSRB 

ASXBLSRB 


2 The stage exit effector sets the stage 3 switch 
(ASCBSSSM) to indicate to the dispatcher that an 

asynchronous event is available for scheduling and causes the 
dispatcher to call the stage 3 exit effector. 

The SETLOCK service checks the stage 2 switch (ASCBS2S) 
when it releases the local lock. 

3 Memory switch is invoked to alert the system of the 
new asynchronous work in the address space. 

If the work is an SRB entry point IEAVEMS2 is called. 

Otherwise IEAVEMS4 is called. 
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Diagram SUP-8. Emergency Signal Second Level Interruption Handler (IEAVEES) (Fart 1 of 8) 
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Diagram SUP-8. Emergency Signal Second Level Interruption Handler (IEAVEES) (Part 2 of 8) 


Extended Description Module Label 

When an emergency signal (EMS) interruption occurs, the 
external FLIH (IEAVEEXT) gives control to the emergency 
signal second level interruption handler (IEAVEES). 

IEAVEES routes control to the specified receiving routine 
to process the emergency signal. 

An emergency signal can be one of three types: 

• A recovery management support (RMS) request 

• A request for serial processing 

• A request for parallel processing 

For RMS requests, IEAVEES branches to an RMS service 
routine. If the request is for serial processing, the signal¬ 
ling routine and receiving routine execute serially. For 
parallel requests, they can execute simultaneously. Step 5 
describes these differences in greater detail. 

*1 IEAVEES establishes a recovery routine to handle IEAVEES 
errors rin the receiving routines and to clear entry 
flags if an error occurs in the emergency signal SLIH. 


Extended Description Module Label 

2 IEAVEES indexes into the PCCA vector table, using 
the PSASPAD, to obtain the signalling processor's 

PCCA. 

3 IEAVEES checks the bits in SCWEES to determine the 
level of the entry. If this is the first or second entry 

level, IEAVEES sets the bits in SCWEES. If this is the 

third entry level, IEAVEES processes as an error and 

continues with step 9. 

4 I EAVEES checks the bits in PCCAEMSI of the sending 
processor to determine if there is a valid request. If 

there is no request, IEAVEES continues at step 6. 
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Diagram SUP-8. Emergency Signal Second Level Interruption Handler (IEAVEES) (Part 3 of 8) 


Input. Output 
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Diagram SUP-8. Emergency Signal Second Level Interruption Handler (IEAVEES) (Part 4 of 8) 

Extended Description Module Label 

5 For an RMS request, IEAVEES gives control to the 
RMS service routine specified in a VCON. For both 

parallel and serial requests, IEAVEES gives control to the 
receiving routine specified in the PCCAEMSE field of the 
signalling processor's PCCA. 

When handling a serial request, IEAVEES informs the sig- IEAVEES RETRYPT 
nailing processor that the request has been received, then 
gives control to the receiving routine. The signalling pro¬ 
cessor spins in IEAVERI while the receiving routine executes. 

After the receiving routine completes, IEAVEES clears the 
serial indicator bit in the PCCAEMSI buffer to allow 
IEAVERI to return control to the issuer of the RISGNL 
macro. If the receiving routine fails, IEAVEES sets the 
fail indicator in PCCAEMSI to allow IEAVERI to abend 
the signalling routine. 

When handling a parallel request, IEAVEES clears 
the parallel indicator bit in the signalling processor's 
PCCAEMSI buffer before giving control to the 
receiving routine. This allows control to be returned 
to the routine issuing the RISGNL macro, which then 
may execute simultaneously with the receiving routine. 

6 I EAVEES cleans up the entry flags set in the SCWA R ETRTN1 

(SCWEES) for IEAVEES. 

7 I EAVEES deletes the recovery environment. 

8 Exits to the external F LIH. 
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Diagram SUP-8. Emergency Signal Second Level Interruption Handler (IEAVEES) (Part 5 of 8) 
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Diagram SllP-8. Emergency Signal Second Level Interruption Handler (IEAVEES) (Part 6 of 8) 


9 Second level recursion has occurred indicating that 
a receiving routine has opened a window without 
proper serialization. IEAVEES deletes the recovery 
environment and abends. This error causes the receiving 
routine to fail and IEAVEES passes the error to the 
signalling routine by setting a bit in PCCAEMSI. 
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Diagram SUP-8. Emergency Signal Second Level Interruption Handler (IEAVEES) (Part 7 of 8) 
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Diagram SUP-8. Emergency Signal Second Level Interruption Handler (IEAVEES) (Part 8 of 8) 

Extended Description Module Label 


10 

Indicates error information in the SDWA 
and VRA areas. 

IEAVEES IEAVEESR 

11 

Depending on the reason entered, uses the SETRP 
macro, indicating to RTM to either retry to the 


mainline or to percolate. 
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Diagram SUP-9. EXIT Prolog Processing (IEAVEEXP) (Part 1 of 6) 


From SVC routines/type 1 ESR routines 
for tasks that cannot receive control after 



> Go to step 3 


Go to step 7 


Output 
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Diagram SUP-9. EXIT Prolog Processing HEAVEEXP) (Part 2 of 6) 

Extended Description 

EXIT prolog performs the exiting procedure for SVCs, in¬ 
cluding EXIT (SVC 3). The exiting SVC routine can pro¬ 
vide information in registers 0,1, and 16. EXIT prolog re¬ 
turns these registers to the SVC caller. 

1 EXIT prolog indicates the SVC issuer cannot be re¬ 
dispatched by setting the force dispatch switch in a re¬ 
gister and goes to step 3. Routines that cannot be redis¬ 
patched after EXIT prolog processing have EXIT prolog, 
when it finishes processing, pass control to the dispatcher. 

2 EXIT prolog indicates that the SVC issuer can be redis- 
patched after processing. 

3 EXIT prolog disables the processor for I/O and external 
interrupts and checks that the SVC exit is in home 

mode (that is, the exit has current addressability to the 
SVC issuer's TCB, RB, and XSB). If the exit is not in home 
mode, EXIT prolog establishes home mode by Issuing a 
CMSET SET macro to the home address space. 

4 If the pointer to the PCLINK stack contains any¬ 
thing except 0, the cross memorv state hss not been 

cleaned up correctly. EXIT prolog issues a PCLINK 
UNSTACK instruction to purge the PCLINK STACK. 


5 EXIT prolog releases all of the locks held by the 60TYP1 

caller of EXIT prolog and then determines the SVC 
type. If the SVC is type 1 (ASCBTYP1 bit equals IK pro¬ 
cessing continues at step 7. 


Module Label 


IEAVEEXP IEAVEXP1 


IEAVEXPR 
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Diagram SUP-9. EXIT Prolog Processing (IEAVEEXP) (Part 3 of 6) 


Input 


Process 


Output 



6 Determine whether to do 
end-of-trek processing. 


if the last RB on the chain 
represents the SVC issuer 

If not the last RB, perform 
special processing. 


7 Return control 


* 


IEAVEOR 


SVC 3 

EXIT routine 




• If the task cannot be redispatched. 


• If the task can be redispatched. 



IEAVEDSO 


Dispatcher 


Return to the caller 
that issued the SVC 


TCB 



TCBRBP 


TCBATT 

TCBPNDSP 

TCBSTPP 

TCBSTPPR 

TCBXSB 


ASCB 
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Diagram SUP-9. EXIT Prolog Processing (DEAVEEXP) (Part 4 of 6) 

Extended Description Module Label 


6 It the last RB on the RB chain represents the SVC 
issuer, for type 2, 3, and 4 SVCs, the EXIT prolog rou¬ 
tine gives control to EXIT to perform end-of-task proces¬ 
sing. 


EXIT prolog performs special processing 

for RBs other than 

the last: 

Fields 

Fields 

Operation 

Read 

Modified 

a) For type 1 SVCs, 


ASCBFLG1 

resets the type 1 


(ASCBTYP1 bit) 

switch. 

b) Completes STATUS 

TCBATT 

TCBATT 

processing for the RB 

TCBSTPPR 

TCBSTPPR 

unless other RBs in¬ 


TCBSTPP 

dicate that stops can¬ 


TCBPNDSP 

not be done. 

c) Gives control to 
IEAVSETS at 
entry point 

IEAVESSS to per¬ 
form stop SYNCH 
processing. 

d) If the task becomes 

RBLINK 

ASCBTCBS 

nondispatchable, de¬ 

RBWCF 


creases the count of 

TCBFLGS4 


ready tasks. 

TCBFLGS5 


e) Dequeues the RB 

RBLINK 

TCBRBP 

and XSB and marks 

RBXSB 

TCBXSB 

the RB inactive, 
f) Purges any SCBs by 

RBSCB 


giving control to 
IEAVTSBP. 

g) Moves registers 2-14 


TCBGRS 

from the RB into the 
TCB. 

h) Depending on how 

RBFDYN 


they were obtained, 

RBNOCELL 



returns dynamic RBs 
and XSBs to the 


SVRB pool 
(RBNOCELL=1) or 
issues a FREEMAIN 
to free them 
(RBNOCELL-O). 


GOTOSVC3 


Extended Description Module 

7 The EXIT prolog analyzes the task dispatchabillty state 
to determine where to pass control. 

If both the stage 3 exit effector flag (ASCBS3S) and the 
TCB attention flag (TCBATT) are set, the attention exit 
must execute before the SVC issuer is given control. (The 
ASCBS3S indicates that an IQE has been queued and that 
the stage 3 exit effector is to be invoked to schedule an at¬ 
tention exit; the TCBATT flag indicates the task is not to 
have an attention exit scheduled on it by the stage 3 exit 
effector.) When the attention exit must execute before the 
SVC issuer is given control, EXIT prolog sets the 
TCBS3MR flag to make the task non-dispatchabte, and 
gives control to the dispatcher at entry point IEA0DS1. 

If the task is non-dispatchable for any of the following rea¬ 
sons, EXIT prolog also gives control to the dispatcher at 
entry point IEA0DS1: 

• The ASCBS3S flag is set, but the TCBATT flag is not, 
indicating that an attention exit must be dispatched be¬ 
fore the task. 

• The force dispatcher switch is set, indicating that the 
task cannot be redispatched. 

• The non-dispatchability flags (TCBFLGS4 and 
TCBFLGS5) are nonzero. 

• The wait count (RBWCF) in the top RB is nonzero, in¬ 
dicating that the task Is in a wait state. 

If none of the above conditions are met, the task can be re¬ 
dispatched. EXIT prolog makes a trace entry; if necessary, 
resets the cross memory state to what it was when the SVC 
was issued by issuing a CMSET RESET macro; and returns 
to the caller that issued the SVC. 


Label 
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Diagram SUP-9. EXIT Prolog Processing (IEAVEEXP) (Part 5 of 6) 
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Diagram SUP-9. EXIT Prolog Processing (EEAVEEXP) (Part 6 of 6) 

Extended Description Module Label 

8 EXIT proloa disables the processor for I/O and external IEAVEXP2 

Interrupts and checks that the SVC exit is in home 

mode (that is, the exit has current addressability to the 
SVC issuer's TCB, RB, and XSB). If the exit is not in home 
mode, EXIT proiog establishes home mode by issuing a 
CMSET SET macro to the home address space. 

9 If the current PCLINK stack is not empty, EXIT proiog 
issues a PCLINK UNSTACK macro with tha PURGE 

option to dear the PCLINK stack. 

10 EXIT proiog restores the PCLINK stack forthe 
issuer of the SVC by placing a pointer to the 

PCLINK stack in the PSASTKE. 

11 EXIT proiog resets the type 1 SVC indicator 
(ASCBTYP1) and releases the locks it currently holds. 

If only the local lock is held, EXIT Prolog uses SETLOCKI 
to release it. 

12 If the task is non-dtspatchable for any of the following 
reasons, EXIT Prolog gives control to the dispatcher. 

Before exiting to the dispatcher, EXIT proiog saves the ex¬ 
iting SV(?s registers 0,1, and 16. 

• The stage 3 exit effector flag (ASCBS3S) is set. 

• The non-dispatchability flags (TCBF LGS4 and 
TCBFLGS5) are set. 

• The wait count (RBWCF) in the top RB Is nonzero, in¬ 
dicating the task is In a wait state. 

Otherwise, EXIT proiog returns to the Issuer of the SVC. 

Before exiting, EXIT proiog does the following: 

» Builds a PSW in the PSA. 

• Traces the SVC return. 

• Flushes the normal FRR stack. 

• Restores the SASIO and PKM to the values current be¬ 
fore the SVC was issued. 

• Restores the original contents of registers 2-14 from the 
TCB. 
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Diagram SUMO. External First Level Interrupt Handler (IEAVEEXT) (Part 2 of 16) 


Extended Description Module Label 

The external FLIH gets control from the external new 
PSW. The FLIH uses the system mode Indicator to 
determine how to save interrupt status. IEAVEEXT 
calls a subroutine to trace the interrupt and route 
control to the appropriate SLIH. The FLIH also 
supports recursive interrupts if an interrupt occurs 
while an external SLIH is in control. 

1 The external FLIH checks a super bit IPSAEXT bit IEAVEEXT IEAQEXOO 
in PSASUPER) to determine if this is a recursive 

entry. If it is, processing continues at step 15. 

2 The system mode at the time of the interrupt 
determines which subroutine in the external FLIH 

should handle the interrupt. IEAVEEXT uses the 
PSAMODEH as an index to reference the proper routine. 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 3 of 16) 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 4 of 16) 

Extended Description Module Label Extended Description Module 

The external FLIH mainline gives control to IEAVEEX1 
when the system is in task mode. 

3 IEAVEEX1: 

• Saves the current FRR stack pointer (PSACSTK) in IEAVEEXT IEAVEEX1 

the PS AES AVI field. 

• Sets the current FRR stack pointer to the external 
FLIH stack (PSAESTK1). 

• Sets the external FLIH super bit in PSASUPER. 
e Saves the CPU timer in LCCAXTIM 

• Saves cross memory control registers 3 and 4 in the 
LCCAXXM1 field. 

• Saves the interrupt registers in LCCAXGR1. 

• Saves the interrupt PSW in LCCAXPSW. 

4 If an emergency signal interrupt occurred or if any 
spin bits are on, the task is not pre-empted, instead, 

processing continues at step 8. 

5 IEAVEEX1 calls the COMMON subroutine which 
tracertne interrupt via system tram and GTF and 

vafctbeappropriate SLIM. After the SLIH completes, 
ii returns control here. 

£ If the home address space is not already the primary 
address space, IEAVEEX1 issues a CMSET SET macro 
to make it so. This allows IEAVEEX1 to store into the 
TCB/RB/XSB or IHSA/XSB. 

IEAVEEX1 saves the status of preemptible work as fol¬ 
lows. 

If the interrupted task is unlocked, IEAVEEX1: 

• Saves the’intarrupted task's registers in TCBGRS from 
LCCAXGPR 

• Saves the PSW in RBOPSW from LCCAXPSW. 

• Copies the interrupted cross memory control registers 
3 and 4 from the LCCAXXM1 field into the 
XSBXMCRS field. 


If the interrupted task holds the LOCAL lock, 

IEAVEEX1 saves status in the IHSA and XSB of the 
home address space. It: 

• Saves the registers in IHSAGPRS from LCCAXGPR 
field. 

• Saves the PSW in IHSACPW from LCCAXPSW field. 

• Copies the interrupted cross memory control registers 
3 and 4 from the LCCAXXM1 field into the 
XSBXMCRS field. 

• If the interrupted task holds the CML lock, 

IEAVEEX1 saves status in the IHSA and XSB of the 
address space whose CML lock is held. It: 

— Issues a CMSET SSARTO macro to establish 
secondary addressability to the address space 
whose CML lock is held. 

— Saves the Interrupted task's registers in the 
IHSAGPRS field from LCCAXGPR. 

- Saves the PSW in the IHSACPSW field from 
LCCAXPSW field. 

— Copies the interrupted cross memory control 
registers 3 and 4 from the LCCAXXM1 field 
to the XSBXMCRS field. 

7 IEAVEEX1 sets the current FRR stack pointer to the 
super stack (PSASSTK) and branches to the dis¬ 
patcher at entry point IEAPDS7, IEAPDS7A, or IEAPDS7C. 


Label 
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Diagram SUP-10. External First Level Interrupt Handler (IEA VEEXT) (Part 5 of 16) 


Input 


From step 2 

or step 4 Process 



IEAVEEX2 SRB/non-preemptive 


8 Perform initialization and 
save the status for entry at 

9 Call COMMON subroutine 
to trace the interrupt and to 
call the appropriate SLIH. 

10 If an EMS interrupt is being 
processed, validate and reset 
the processor's cross memory 
environment. If not an EMS 
interrupt, restore the processor's 
cross memory environment 
only. 

11 Reload the status of the 
interrupted routine. 

IEAVEEX3 wait mode 

12 Establish recovery, clear 
waiting processor and 
active dispatcher indicators 
and accumulate processor 
waiting time. 

13 Call COMMONCR subroutine 
to trace the interrupt and 

to call the appropriate SLIH. 


14 Establish a recovery environ¬ 
ment for entry to the dis¬ 
patcher. 
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Diagram SUJP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 6 of 16) 


Extendod Description Module Label 

IEAVEEX2 receives control from the external FLIH 
mainline when the system is in SRB mode, or from 
lEAVEEXIqwhen an interrupted task is not to be 
preempted. 

8 IEAVEEX2: IEAVEEXT IEAVEEX2 

• Saves the current FRR stack pointer (PSACSTK) in 
the PSAESAV1 field. 

• Sets the current stack pointer to the external FLI H 
stack (PSAESTK1). 

• Sets the external F LI H super bit in PSASUPER. 

• Saves the processor timer in LCCAXTIM. 

• Saves the interrupted cross memory control registers 
3 and 4 in the LCCAXXM1 field. 

• Saves the registers in LCCAXGR1 

• Saves the PSW in LCCAXPSW 

0 IEAVEEX2 calls the COMMON subroutine, which 
traces the interrupt via system trace, and GTF, and 
calls the appropriate SLIH. After the SLIH completes, 
it returns control here. 

io * an EMS interrupt is being processed, IEAVEEX2 
issues a CMSET RESET CHKAUThMYES) macro. 

The macro processor (IEAVECMS) checks whether 
the primary and secondary ASIDs can be accessed using 
cross memory instructions and whether they can access 
each other. If they can, IEAVECMS reloads cross mem¬ 
ory control registers 1,3,4, 5, and 7. If the cross mem¬ 
ory state is invalid, IEAVECMS issues abend X'058' 
with the appropriate reason code. 


Extended Description Module Label 

in order to validate and reset the processor's cross mem¬ 
ory environment. See the IEAVEBBR diagram for de¬ 
tails on when IEAVEBBR issues an EMS. See the 
IEAVECMS diagram for a description of CMSET RESET 
processing. 

If the interrupt was not an EMS interrupt, IEAVEEX2 
issues a CMSET RESET, CHKAUTH°NO macro. This 
restores the cross memory controls to the state they were 
in when the interrupt occurred. 

11 IEAVEEX2 reloads the status of the interrupted 
routine and returns control to the interrupted 

routine. 

The external FLIH mainline gives IEAVEEX3 control 
when the system is in wait mode. 

12 IEAVEEX3: IEAVEEXT IEAVEEX3 

• Saves the current FRR stack pointer (PSACSTK) in 
the PS AES AVI field. 

p Sets the current stack pointer to the external stack 
1 (PSAESTK1). 

• Sets the external FLIH super bit in PSASUPER. 

• Saves the processor timer in PSACPUT. 

• Accumulates wait time in LCCAWTIM. 

• Clears SVTDACTV and SVTPWAIT. 

13 IEAVEEX3 calls the COMMONCR subroutine, which 
traces the interrupt via GTF and calls the appropriate 

SLIH. After the SLIH completes, it returns control here. 


14 IEAVEEX3 sets the current FRR stack pointer 
to the super stack (PSASSTK) and branches to 
the dispatcher at entry point IEAPDS7B. 


IEAVEEX2 issues the CMSET macro in case the bind 
break routine (IEAVEBBR) caused the EMS interrupt 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 7 of 16) 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 8 of 16) 

Extended Description Module Label 

The external FLIH mainline gives IEAVEEX5 control 
when an interrupt occurs while the dispatcher is making 
a recursive scan of the dispatching queues before entering 
a wait state, or while the dispatcher is spinning on an 
intersect flag waiting to proceed. 

15 IEAVEEX5: IEAVEEXT IEAVEEX5 

o Saves the current FRR stack pointer in the 
PSAESAV1 field. 

o Sets the external FLIH super bit in PSASUPER. 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 9 of 16) 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 10 of 16) 

Extended Description Module Label 

16 When no spin bits are set, IEAVEEX5 preempts the 
interrupted routine. It: 

• Clears the dispatcher active and processor waiting 
flags (the SVTDACTV and SVTPWAIT fields, re¬ 
spectively). 

• Branches to the COMMONCR subroutine (step 18) 
which traces the interrupt and routes control to the 
appropriate SLIH. 

• Makes the super stack current for the dispatcher. 

• Branches to the dispatcher at entry point IEAPOS7B. 

17 When spin bits are set, instead of preempting the 
interrupted routine, IEAVEEX5 returns control 

to it after the interrupt has been processed. IEAVEEX5: 

e Saves the interrupted routine's registers in the LCCAXGR1 
field. 

e Saves the interrupted routine's PSW in the LCCAXPSW 
field. 

e Saves the interrupted routine's cross memory 
control registers 3 and 4 in the LCCAXXM1 
field. 

e Branches to the COMMONCR subroutine (step 18), 
which traces the i n t e rr u pt and routes control to the 
appropriate SLIH. 

• After the SLIH returns control, restores the status of 
the interrupted routine, and returns to it. 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 11 of 16) 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 12 of 16) 


18 The COMMON and COMMONCR routines trace the IEAVEEXT COMMON 

external Interrupt by invoking the system trace and COMMONCR 

the generalized trace facility (GIF). IEAVEEXT obtains 
cross memory status from the LCCAXXM1 in COMMON 
and from the current control registers 3 and 4 in COMMONCR. 

The routines are otherwise the same. 

19 The external FLIH determines what type of external 
interrupt occurred and routes control to the appropri¬ 
ate SLIH. 

• External call (IEAVEXS) — Occurs after a user issues 
an external call SIGP (signal processor) instruction. 

• Emergency signal (IEAVEES) — Occurs after a user 
issues an emergency signal SIGP instruction. 

• Timer (module IEAVRTIO, entry point IEAOTIOO) — 

Occurs when a selected timer interval expires or when 
a TOD synch check occurs. 

• Monitoring and system support facility (MSSF) or 
Service processor architecture (IEAVMFIH) — Occurs 
after the service processor signals the completion of a 
software-requested service. 

• Malfunction alert (IGFPXMFA) — Occurs if another 
processor fails. 

• Communications task (IEEBC1PE) — Occurs when the 
operator presses the external interrupt key on the 
operator's console. 

When the SLIH completes, it returns control to the caller of 
COMMON or COMMONCR. 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Fart 14 of 16) 

Extended Description Module Label 

The RECURSE routine receives control when an 
external interruption occurs while an external SLIH 
is active. Two levels of recursion are allowed. 

20 IEAVEEXT determines if this is the first or second IEAVEEXT RECURSE 

recursion. If this is the second recursion, continues 

processing at step 25. 

21 For the first level recursion, IEAVEEXT: 

• Saves the current FRR stack pointer (PSACSTK) 
in PSAESAV2 field. 

• Sets the current FRR stack pointer to the external 
stack 2 (PSAESTK2) 

• Saves the registers in LCCAXGR2. 

• Saves the old PSW in LCCAXPS2. 

• Saves the cross memory control registers 3 and 4 
in LCCAXXM2. 

• Sets the recursion flag in LCCAIHR1. 

22 RECURSE calls tha COMMONCR subroutine to 
system and GTF trace the interrupt and to call 

the appropriate SLIH. After the SLIH completes, control 
is returned to here. 

23 IEAVEEXT restores the status of the interrupted 
routine and returns control to it. 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 15 of 16) 
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SECOND (Recursion routine) 


If the second level recursion 
bit has already been set, issue . 
an ABEND. 

Establish recovery and save 
interrupt registers and cross 
memory status. Set second 
level recursion bit. 

Call COMMONCR subroutine 
to trace the interrupt and call ^ 
the appropriate SLIH. 

Restore the status of the 
interrupted program. 


Clear the external interruption- 
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level of recursion. 
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Diagram SUP-10. External First Level Interrupt Handler (IEAVEEXT) (Part 16 of 16) 


Extended Description 


Module Label Extended Description 


Module Label 


If an external interrupt occurs while IEAVEEXT is 28 The external FLIH has three retry routines which 

processing a previous recursive external interrupt. IV S CO the supervisor FRR (IEAVESPR) will retry to. 


IEAVEEXT gives control to the SECOND subroutine. 

24 If the second level recursion indicator (LCCAIHR1) 

has already been set, IEAVEEXT gives control to 

the THIRD subroutine to issue ABEND X'3FC* with reason 

code 0. 

25 For the second level recursion, SECOND: 

• Saves the current FRR stack pointer (PSACSTK) 
in the PSAESAV3 field. 

• Sets the current FRR stack pointer (PSACSTK) 
to the external stack 3 (PSAESTK3). 

• Saves the registers in LCCAXGR3. 

• Saves cross memory control registers 3 and 4 
in the LCCAXXM3 field. 

• Sets the second level recursion indicator (the 
LCCAIHR1 flag). 

26 SECOND calls the COMMONCR subroutine to trace 

the interrupt via system trace and GTF and to call 

the appropriate SLIH. After the SLIH completes, it 

returns control here. 


The retry routine is chosen based upon whichever FRR 
stack is the current stack when the interrupt occurs. 

These routines clear various external FLIH recursion 
indicators, restore the previous (saved) FRR stack, and 
ABEND the program which received the interrupt. 

RETRY Routine Clears Indicator Restores FRR Stack From 

IEAVEE1R PSA EXT PSA ESA VI 

IEAVEE2R LCCAXRC1 PSAESAV2 

IEAVEE3R LCCAXRC2 PSAESAV3 

29 All three retry routines issue a PTLB instruction 
to ensure that there is no invalid information in 

the DAT translation buffers. 

30 All three retry routines issue an ABEND macro with 
an X*3FC completion code to terminate the program 

which was running when the external interrupt occurred. 


27 After the SLIH returns, SECOND restores the status 
of the interrupted routine and returns control to 
the interrupted routine. 
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Diagram SUP-11. Stage 1 Exit Effector (1EAVEF00) (Part 1 of 2) 
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Diagram SUP-11. Stage Exit Effector (IEAVEFOO) (Part 2 of 2) 

Extended Description Module 

The stage 1 exit effector is called by supervisor or data 
management routines. Its purpose is to create and initialize, 
according to input parameters, an IRB (interruption request 
block) to control a user exit routine whose future use is 
requested by the caller. 

1 The stage 1 exit effector calls GETMAIN to obtain IEAVEFOO 
storage for the IRB from LSQA, subpool 253. 

2 The caller may request a work area to be appended to 
the IRB. This work area will be released when the IRB 

is freed. 

3 Stage 1 exit effector obtains storage for the save area 
from the problem program's subpool 0, if requested. 

4 The information placed in the IRB during initialization 
includes the save area address, the entry point address 

and addressing mode of the user exit routine, the size of the 
RB, the PSW to be loaded to start execution of the asynchronous 
exit routine, and bits indicating whether the IRB should be freed 
by EXIT. 


Label 
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IGC043BR 
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Diagram SUP-12. INTERSECT Processing (IEAVEINT) (Part 2 of 6) 

Extended Description Module Label 

The intersect function provides a means to serialize process¬ 
ing with the dispatcher. The INTSECT macro provides the 
interface to this function. If an invoker of the INTSECT 
macro was assembled with pre-MVS/XA macro libraries, the 
INTSECT macro passes control to the intersect module to 
ensure that the dispatcher has exited on all processors. 

Otherwise, the INTSECT macro makes an inline check of 
the dispatcher active field (SVTDACTV). If the dispatcher 
active field is non-zero, the INTSECT macro passes control 
to the intersect module which will wait for the dispatcher to 
exit each online processor. 

Two levels of intersect are provided: 

• Local 

The routine that requests the. intersect must hold the local 
lock. The requesting routine then issues the INTSECT macro; 
which turns on the requestor's intersect bit in the local 
intersect field (ASCBSRQ). If the invoker was assembl¬ 
ed with MVS/XA macros, the INTSECT macro 
checks the dispatcher active field (SVTDACTV) for zeros. 

If SVTDACTV is zero, indicating that the dispatcher is not 
active, the requesting routine continues processing. If 
SVTDACTV is non-zero, the macro branches to the intersect 
module at entry point IEAVEINL to perform the required 
serialization. If the invoker was assembled with pre- MVS/XA 
macro libraries, the INTSECT macro passes control to the 
intersect module at entry point IEAVEINT. Note that 
the pre - MVS/XA 44>yte SVTDACTV field is initialized 
to all X'FF's. This forces control to be passed to the service 
routine at IEAVEINT, which checks the new 16-byte 
SVTDACTV field. 

• Global 

The routine requesting the global intersect must hold the 
dispatcher lock. The macro turns on the requestor's inter¬ 
sect bit in the global intersect field (SVTDSREQ). jf the 
invoker was assembled with MVS/XA macro 
libraries the INTSECT macro checks the dispatcher ac¬ 
tive field (SVTDACTV) for zeros. If SVTDACTV is zero, 


Extended Description 


Module 


Label 


indicating that the dispatcher is not active, the requesting 
routine continues processing. If SVTDACTV is non-zero, 
the INTSECT macro branches to the intersect module 
(IEAVEINT) at entry point IEAVEING to perform the 
required serialization. If the invoker was assembled with 
pre - MVS/XA macros, the INTSECT macro passes control 
to the intersect module at entry point IEAVEINT. 

1 If the function was entered at the entry point IEAVEINT IEAVEINT 

IEAVEINT and the dispatcher active field is zero, IEAVEINL 

IEAVEINT returns to the caller. IEAVEINT determines IEAVEING 

the state of the caller (either enabled or disabled). If dis¬ 
abled, the module continues processing at step 5. 

2 IEAVEINT saves the caller's registers 0 through 14 
in the intersect local work save^area. If the caller Is 

enabled, IEAVEINT assumes that the local lock is held 
since the dispatcher lock Is a disabled lock. The local lock 
serializes the local work save areas. 

3 The spin on the dispatcher active field (SVTDACTV) IEAVEINT SPINENBL 

ensures serialization with the dispatcher in the follow¬ 
ing way. IEAVEINT examines the SVTDACTV one byte at 

a time. When one byte becomes zero, indicating the corres¬ 
ponding processor's dispatcher Is not active, IEAVEINT 
examines the next byte. After all 16 bytes have become 
zero, proper serialization has been obtained and IEAVEINT 
returns to the module that issued the INTSECT macro. 

In order to ensure that the dispatcher does not interfere 
with an intersecting routine, the dispatcher checks the local 
intersect word (ASCBSRQ) for zero before searching the 
TCB queue in the address space. A nonzero ASCBSRQ 
indicates that the requesting routine owns the local inter¬ 
sect and that the dispatcher should not change anything In 
the address space. Therefore, if the ASCBSRQ is nonzero, 
the dispatcher will look at the next address space. 

4 The serialization process is now complete. The 
registers are reloaded from the local work save area, 

and control is passed to the caller. 
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Diagram SUP-12. INTERSECT Processing (IEAVEINT) (Part 4 of 6 ) 

Extended Description Module Label 

Requestor Disabled 

5 IEAVEINT saves the caller's registers 1 through 8 In IEAVEINT SPINDSBL 
the LCCA intersect save area and establishes 
IEAVINTR as the functional recovery routine for the dis¬ 
abled spin processing described below. (See "Recovery 
Processing" at the end of this extended description for a 
description of IEAVINTR). 

3 IEAVEINT examines the dispatcher active field 
(SVTDACTV) one byte at a time until the byte 
is zero. Since this is a disabled spin, the dispatcher 
issues the WINDOW macro to accept an emergency 
signal (EMS) or malfunction alert (MFA) and determines 
if ACR processing is required. If an ACR condition has 
occurred, IEAVEINT gives up control to RTM so that work 
on the dead processor can run. If the time spent in this dis¬ 
abled spin loop becomes greater than a global constant, 

IEAVEINT calls IEEVEXSN, the spin notification routine, 
to give the operator the option of initiating ACR. 

7 When all bytes of the dispatcher active field 

(SVTDACTV) have been tested and become zero, 
serialization is complete. IEAVEINT removes IEAVINTR 
from the FRR stack, reloads registers 1 through 8 from the 
LCCA intersect save area, and returns control to the caller. 
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Diagram SUP-12. INTERSECT Processing (IEAVEINT) (Part 5 of 6 ) 
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Diagram SUP-12. INTERSECT Processing (IEAVEINT) (Part 6 of 6) 

Extended Description Module Label Extended Description Module Label 


Local Intersect Reset 

The Intersect module Is entered using the INTSECT 
macro on a local intersect reset when the post bits are on 
in the local intersect word (ASCBSRQ). The dispatcher 
turns on the post bits before dispatching the wait task 
when the local intersect is not available for an address 
space that might have work ready. 

Note: Post bits exist in the local intersect word 
(ASCBSRQ) and are set by the dispatcher to request not¬ 
ification when the local intersect becomes available. 

8 After disabling the processor, IEAVEINT saves the IEAVEINR 

work registers in the PSA single level save area. 

9 IEAVEI NT examines the local intersect word 
(ASCBSRQ), ignoring|the post bits. If any otlv 

intersect bits are bn, the routine returns to the caller. 

10 If only the post bits are on, IEAVEINT signals 
welting processors to enter the dispatcher to pro¬ 
cess any work that might now be ready. IEAVEINT 
uses the SVTPWAIT field to determine which processors 
are waiting. It uses a SIGP instruction to signal them. 

11 IEAVEINT restores the registers from the PSA single 
level save area, and returns control to the caller. 


Recovery Processing 

When an error occurs while IEAVEINT is in a disabled IEAVEINT IEAVINTR 
spin loop waiting for the dispatcher active field to go to 
zero, RTM gives control to IEAVINTR. IEAVINTR saves 
(in the variable recording area of the SDWA) the current- 
locks-held string (PSACLHS), the global intersect word 
(SVTDSREQ), the dispatcher active field (SVTDACTV), 
and the local intersect word (ASCBSRQ). If a restart 
interrupt caused the entry, IEAVINTR checks whether 
IEAVEINT was in a valid spin loop at the time of the in¬ 
terrupt. If it was, IEAVINTR issues a SETRP macro to 
return the ID of the processor that Is keeping IEAVEINT 
in the spin (the processor with the non-zero dispatcher 
active byte). The macro also requests that the error be 
recorded in the SDWA. IEAVINTR then returns to RTM, 
and RTM signals the processor causing the spin via SIGP 
restart. 

If IEAVEINT is not in a valid spin loop, IEAVINTR 
issues an SETRP macro requesting an SDUMP, error 
recording, and percolation. 
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Diagram SUP-13. I/O Interrupt Handler (IEAVEIO) (Part 1 of 14) 
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Diagram SUP-13. I/O Interrupt Handler (IEAVEIO) (Part 10 of 14) 

Extended Dttcription Mojito Label 

13 When the Interrupt occurs while the system is IEAVEIO IEAVEI03 

in wait mode, the I/O FLIH: 

• Sets the I/O FLIH super bit in the PSASUPER. 

• Saves the CPU timer in the PSACPUT. 

14 The I/O FLIH accumulates the wait time by calculating 
the amount of time in wait state and adding It to the 

LCCAWTIM. It also sets to zero the dispatcher active 
(SVTDACTV) and processor waiting (SVTPWAIT) fields. 

15 The I/O FLIH: 

• Sets the return address so that the I/O SLIH will return 
directly to the dispatcher at entry point IEAPDS7B. 

• Passes control to the I/O SLIH. 

16 When the interrupt occurs while the system is in dis¬ 
patcher mode, the I/O FLIH: 

IEAVEI04 

• Sets the I/O FLIH super bit in PSASUPER. 

• Sets to zero the dispatcher active byte (SVTDACTV} and 
the processor waiting byte (SVTPWAIT). 

17 The I/O FLIH: 

• Sets the return address so that the I/O SLIH will return 
directly to the dispatcher at entry point IEAPDS7B. 

• Passes control to the I/O SLIH. 
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Diagram SUP-13. I/O Interrupt Handler (IEAVEIO) (Part 11 of 14) 
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Diagram SUP-13. I/O Interrupt Handler (IEAVEIO) (Part 12 of 14) 


Extended Description Module 

18 When the interrupt occurs while the system is in 
TCB mode, the I/O FLIH determines if an SRB 

is scheduled to a higher priority address space by 
comparing the dispatching priorities of the SRBs target 
address space and the home address space. If the target 
address space is a higher priority, the I/O FLIH sets the 
PSA I OPR bit. 

If the interrupted task and the task associated with the 
SRB is for the same address space, the PSAIOPR bit is 
also set, since the relative priorities of the tasks are unknown. 

19 The I/O FLIH places the SRB on the global SRB 
queue. 

20 there is a processor in a wait state, the I/O F LIH resets IEAVESCO 
the PSAIOPR bit to zero and calls the schedule 

module (IE A VESCO) to signal the waiting processor. 

The I/O FLIH then returns to IOS. 


Label 

IEAVEIOP 


IEAVESC4 
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Diagram SUP-13. I/O Interrupt Handler (DEAVEIO) (Part 13 of 14) 
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Diagram SUP-13. I/O Interrupt Handler (IEAVEIO) (Part 14 of 14) 


Extended Description Module 

Recovery Processing: 

21 Control is received when the I/O FLIH recovery rou¬ 
tine (IEAVEIOR) indicates to continue retry pro¬ 
cessing after an error. The system mode determines which 
routine is to continue retry processing. IEAVEIO uses 
PSAMOOEH as an index to the internal table IORETTAB 
to reference the proper routine. 

22 If the error occurred when the I/O SLIH was invoked 
to process a task mode or SRB mode I/O interrupt, 

resume normal processing by exiting to entry point 
IEAVEIOX of IEAVIO. 

23 The I/O FHIL FRR (IEAVEIOR) clears the I/O FLIH 
super bit in PSASUPER and points the FRR stacker 

pointer (PSACSTK) in the PSA to the normal FRR stack. 

It then ABENDS the interrupted program with a X'2FC' 
completion code. 


Label 

IEAVEIOX 

IEAVEIOR 
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Diagram SUP-14. Low-Storage Refresh (IEAVELCR) (Part 2 of 2) 


Extended Detcription Module 

IEAVELCR checks, and if necessary, refreshes critical 
fields in the PSA, SVT, CVT, ASVT, and the GDA. 

1 Refreshes static fields in the PSA. 

2 Refreshes the critical values in the SVT. 

3 Refreshes the PSA secondary pointer to the CVT 
(FLCCVT2). 

4 Refreshes the VCONs in the CVT. 

5 Refreshes the PSA pointer to VTAM's CVT 
(PSAATCVT) from VTAM's vector table (AVT). 

6 Refreshes pointers to critical system control blocks. 

These control blocks are the ASVT, PCCA, CSD, and 

the GDA, The ASVT max user's field and related 
fields are recalculated and refreshed: 

* ASVTMAXI - The installation specified max user's count. 

* ASVTNONR - The number of ASVT entries reserved to 
replace non-reusable ASIDs. 

* ASVTSTRT - The number of ASVT entries reserved for 
STARTed/SASI address spaces. 

* ASVTMAXU - The installation specified max user's count 
plus the number of ASVT entries reserved to place 
non-reusable ASIDs and the number of ASVT entries 
reserved for STARTed/SASI address spaces. 

These pointers and fields are checked against write protected 
fields in the GSDA. The SPTT (subpool translator table pointer) 
is refreshed via a VCON. 

7 Refreshes the pointer to the PCCA (PSAPCCAV). 

The alternate path to the PCCA is 
CVTPCCAT PCCATOOP -►PCCA. If both the 
PSAPCCAV and the PCCATOOP for this processor fail 
LRA checks, then this processor is set to a disabled 
wait with a PSW wait code X'083'. 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 



Diagram SUP-15. Spin Lock Manager Processing (IEAVELK) (Part 1 of 8) 
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Diagram SUP-15. Spin Lock Manager Processing (IEAVELK) (Part 2 of 8) 

Extended Description Module Label 

The spin lock manager provides the means for a user to IEAVELK 
obtain locks that serialize the use of a resource. The lock 
manager provides the following locks: 

• RSMGL (RSM global lock) 

• VSMFIX (VSM fixed subpools lock) 

• ASM (auxiliary storage management lock) 

• ASMGL { ASM global lock) 

• RSMST (RSM steal lock) 

• RSMCM (RSM common lock) 

• RSMXM (RSM cross memory lock) 

• RSM AD (RSM address space lock) 

• RSM (RSM lock, shared/exclusive) 

• VSMPAG (VSM pageable subpools lock) 

• DISP (dispatcher lock) 

• SALLOC (space allocation lock) 

• IOSYNCH (IOS synchronization lock) 

• IOSUCB (IOS unit control block lock) 

• SRM (the system resource management lock) 

• TRACE (TRACE lock, shared/exclusive) 

• CPU (processor lock) 

The lock manager both obtains and releases locks. There 
are two distinct methods of obtaining locks; conditionally 
and unconditionally. If the lock cannot be obtained for a 
conditional request, the lock manager immediately re¬ 
turns control to the caller with the appropriate return 
code in register 13. If an unconditional request fora spin 
lock cannot be satisfied, the lock manager keeps control 
until the lock Is obtained. 

Note: 

for non-class spin locks, step 3 is performed prior to steps 
1 and 2. 


Extended Description 


Module 


Label 


1 If an unconditional request for a multiple level spin lock IEAVELK 
is presented, the lock manager determines whether the 

caller has violated the locking hierarchy by: 

• Unconditionally requesting a lock lower in the hler- 
archy than a lock It already holds. 

• Requesting a class lock when another lock In that 
class is already held. 

The lock manager abnormally terminates callers who vio¬ 
late the hierarchy with a X'073* completion code and a 
reason code of X'08' in register 15. 

2 The lock manager determines whether this processor 
already owns the requested lock, if this processor 

owns it, the lock manager puts a return code of 4 in register 
13, and returns control to the caller. Otherwise, processing 
continues. 

3 The lock manager tries to obtain the lock. If the lock 
is available (the lockword contains 0), the lock man¬ 
ager indicates ownership by: 

• Placing into the lockword the logical processor ID. 

• Setting the appropriate bit in the processor-locks-held 
string (PSACLHS) 

• For any class lock, storing the address of the lockword 
into the processor-locks-held table (PSACLHT) 

The lock manager then returns to the caller with a zero 
return code. If the lock is not available, processing con¬ 
tinues at step 4. 
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Diagram SUP-15. Spin Lock Manager Processing (IEAVELK) (Part 3 of 8) 
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Diagram SUP-15. Spin Lock Manager Processing (IEAVELK) (Part 4 of 8) 


n a 


ffmmrfwl ritnriaafcin Module Label Extended Description Module Label 

4 

• For conditional requests, IEAVELK sets one of the 
following return codes: 

X '04' — Lock already owned by caller. 

X '08' — Lock held by another processor. 

X'10' — Level error detected. (Level errors are only 
defined for multiple level locks.) 

• For unconditional requests for multiple level spin 
locks, IEAVELK determines if a level error has 
occurred. A level error indicates that: 

• The caller is attempting to use the same lockword to 
represent two distinct locks. This is detected if 

the PSACLHT slot for the lock requested is zero, 
the lockword contains the current CPU ID, and 
another PSACLHT slot contains the user-supplied 
lockword address. 

• The caller is attempting to use two different 
lockwords for the same lock. This is detected if 
the PSACLHS indicates the lock is held but the 
PSACLHT slot contains a lockword address 
different than the user-supplied lockword address. 

If a level error has been detected, the lock manager 
abnormally terminates the lock request with a 
completion code of X'073' and a reason code of 

X '28* in register 15, if the request was for un¬ 
conditional ownership. A return code of X'10' 
is generated for level errors detected on conditional 
requests. 
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Diagram SUP-15. Spin Lock Manager Processing (IEAVELK) (Part 5 of 8) 
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Diagram SUP-15. Spin Lock Manager Processing (IEAVELK) (Part 6 of 8) 

Extended Description Module Label 

5 If the processor cannot obtain the lock for a valid 

unconditional request, the lock manager loops {"spins") 

to check if the lockword is zero. 

a) IEAVELK issues a SETFRR macro to establish ELKFRR 
as the functional recovery routine (FRR), turns on the 
lock manager super bit, and calculates the spin loop time 
out count. 

b) The lockword is checked again to see if it is zero. If it 
is, IEAVELK turns off the super bit, issues the 
SETFRR macro to delete the FRR, and resumes pro¬ 
cessing at step 3, where it tries to obtain the lock again. 

c) The lock manager issues a WINDOW macro to enable 
EMS (emergency signal) and MFA (malfunction alert) 
interruptions. (This is done to prevent deadlock in case 
of failure on the other processor.) 

d) The lock manager then determines if an ACR (alternate 
CPU recovery) condition occurred. If so, it returns con¬ 
trol to RTM and turns off the super bit, issues the 
SETFRR macro to delete the FRR, and resumes pro¬ 
cessing at step 3, where it tries to obtain the spin lock 
8gain. 

e) If lock ownership has changed, lock manager restarts 
the spin at step 5b, resetting the spin loop time count. 

f) If the spin loop count is zero, the lock manager calls 
IEEVEXSN to inform the operator of the excessive 
spin and restarts the spin loop at step 5a by resetting the 
spin loop time count. 

Otherwise, IEAVELK goes to step 5b to check the lock- 

word and repeats the loop. 
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Diagram SUP-15. Spin Lock Manager Processing (IEAVELK) (Part 8 of 8) 

Extended Description Module Label 

Q The lock manager releases the locks when the caller 
issues the SETLOCK macro using the RELEASE 
operand. 

IEAVELK determines if the lock is held by this processor. 

• If the processor owns the lockword, the lock manager 
releases it by setting the lockword to zeros. 

• If the lock is not held by this processor, IEAVELK 
returns to the caller with a return code in register 13. 

If no processor holds the lock, the return code equals 
X'04'; if another processor owns the lock, it equals 
X'08'. 

7 IEAVELK updates the lock indicators by clearing the 
appropriate bit in the locks-held string. I f this is a class 

lock, IEAVELK clears the appropriate entry in the locks- 
held table. 

8 If any one of the following conditions is met, 

IEAVELK returns to the caller in a disabled state. 

a A spin lock is held, 
a A super bit is set. 

a The caller requested control be returned in a disabled 
state. 

Otherwise, IE AVE LK returns in an enabled state. I n either 
case, the return code is zero. 
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Diagram SUP-16. Obtaining Shared/Exclusive Locks (IEAVELK) (Part 2 of 6) 


r- a 


Extended Description Module Labe! 

1 The lock manager determines if the lock requested is 
already held by the caller or if a higher lock in the 

locking hierarchy is already held. If so, continue at step 4. 

2 The lock manager tries to obtain the lock. If the lock- 
word is available, then: For shared requests, the 

exclusive ownership and exclusive pending bits 0 and 1 of 

the lockword must be zero; for exclusive requests, the 

lockword must be zero. Ownership of the lock is indicated 

as follows: 

• If the lock is obtained shared the lock manager turns on 
the appropriate bit reflecting the requesting processor. 

(Bits 16-31 of the lockword represent CPU 0 through F, 
respectively). 

• If the lock is obtained exclusive, the lock manager sets 
the appropriate bit in the low order two bytes. Bit 0 
of the lockword is set to one to indicate exclusive 
ownership. 

3 For conditional requests, IEAV E LK returns a return 
code of 8 in register 13. 
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Diagram SUP-16. Obtaining Shared/Exclusive Locks (IEAVELK) (Part 3 of 6) 
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Diagram SUP-16. Obtaining Shared/Exclusive Locks (IEAVELK) (Part 4 of 6) 

Extended Description Module Label 

4 

• If a shared lock is requested, the lock manager considers 
the lock available when the exclusive ownership bit and 
the exclusive pending bit (bits 0 and 1 of the lockword, 
respectively) become zero. 

• If exclusive ownership is requested, the lock manager 
considers the lock available when either the lockword 
becomes zero or the only bit on in the lockword is the 
exclusive pending bit. 

• If the processor cannot obtain the lock for a valid 
unconditional request, the lock manager loops (“spins") 
to check if the lockword Is zero. 

a) IEAVELK issues a SETFRR macro to establish 
ELKFRR as the functions recovery routine (FRR), 
turns on the lock manager super bit, and calculates 
the spin loop time-out count. 

b) The lockword is checked again to see if it is zero. 

If it is, IEAVELK turns off the super bit, issues the 
SETFRR macro to delete the FRR, and resumes 
processing at step 2, where it tries to obtain the lock 
again. 

c) The lock manager issues a WINDOW macro to enable 
EMS (emergency signal) and MFA (malfunction 
alert) interruptions. (This is done to prevent dead¬ 
lock in case of failure on the other processor.) 

d) The lock manager then determines if an ACR (alter¬ 
nate CPU recovery) condition occurred. If so, 
returns control to RTM and turns off the super bit. 

Issues the SETFRR macro to delete the FRR, and 
resumes processing at step 2, where it tries to obtain 
the spin lock again. 

e) If the spin loop count is zero, the lock manager calls 
IEEVEXSN to inform the operator of the excessive 
spin and restarts the spin loop at step 4a by resetting 
the spin loop time count. 

Otherwise, IEAVELK goes to step 4b to check the 
lockword and repeats the loop. 
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Diagram SUP-16. Obtaining Shared/Exclusive Locks (IEAVELK) (Part 5 of 6) 
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Diagram SUP-16. Obtaining Shared/Exclusive Locks (IEAVELK) (Part 6 of 6) 

Extended Description Module Label 

5 If a lock held is higher than the one requested, the caller 
abnormally terminates with a completion code of 

X'073' and a reason code of X'08' in register 15. 

6 The caller owns the lock requested. The lock manager 
validates the request by checking if the lock is 

held with the same scope as was requested. 

• If the scope is different, abnormally terminates the 
caller with a completion code of X'073 f and a reason 
code of X‘24' in register 15 

• If the scope is the same, returns control to the caller 
with a return code of X'04' in register 13. 
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Diagram SUP-17. Releasing Shared/Exclusive Locks - Unconditional and Conditional (IEAVELK) (Part 1 of 4) 
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Diagram SUP-17. Releasing Shared/Exclusive Locks - Unconditional and Conditional (IEAVELK) (Part 2 of 4) 

Extended Description Module Label 

1 IEAVELK determines rf the lock is held by this 
processor. 

• If the lock is not held by this processor, IEAVELK 
returns to the caller with a return code of X'04' In register 
13. 

• If the lock is being released with a different scope attribute 
than was specified when the lock was obtained, the 
caller abnormally terminates with a completion code 

of X'073' and a reason code of X'24*. 

e If the lock is being released as shared, resets the corres¬ 
ponding ownership bit in bit positions 16-31 of the 
lockword to zero. 

• If the lock is being released as exclusive, resets the 
corresponding ownership bit in bit positions 16-31 
of the lockword to zero. Additionally, resets the 
exclusive ownership bit (bit 0 of the lockword) to 
zero. After releasing the lock as exclusive, 

the only bit in the lockword that could still be on 
is the exclusive pending bit (bit 1 of the lockword). 
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Diagram SUP-17. Releasing Shared/Exclusive Locks - Unconditional and Conditional (IEAVELK) (Part 3 of 4) 
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Diagram SUP-17. Releasing Shared/Exclusive Locks — Unconditional and Conditional (IEAVELK) (Part 4 of 4) 

Extended Description 

2 IEAVELK updates the lock indicators by clearing 
the appropriate bit in the current locks held string. 

If the lock was released as exclusive, IEAVELK also 
sets the high order bit of the corresponding current 
locks held table (PSACLHT) slot to zero to indicate 
that the lock is no longer held. 

3 If any one of the following conditions is met, 

IEAVELK returns to the caller in a disabled state: 

• A spin lock is held. 

• A super bit is set. 

• The caller requested that control be returned in a 
disabled state. 

Otherwise, IEAVELK returns in an enabled state. In 
either case, the return code is zero. 
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Diagram SUP-18. Obtaining CPU Lock (IEAVELK) (Pint 2 of 2) 


Extended Description Module 

1 IEAVELK disables the PSW for I/O and external IEAVELK 

interrupts to serialize the CPU lockword, PSACPUL 

2 IEAVELK sets bit 0 of the current locks held string, 

PSACLHS, to one to indicate that the CPU lock is 

owned on this processor. 

3 IEAVELK increments the CPU lock count in the 
CPU lockword, PSACPUL, by one. 

4 IEAVELK sets a return code of zero in register 13. 


Label 


CPUOBT 
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Diagram SUP-19. Releasing the CPU Lock (IEAVELK) (Part 2 of 4) 

Extended Description Module 

1 If the CPU lock held bit is off in the current locks 

held string, PSACLHS, IEAVELK goes to step 7. IEAVELK 

2 IEAVELK decreases the CPU lock count in the CPU 
lockword, PSACPUL,by 1. 

3 If the count has gone to zero, I EAVELK turns off the 
CPU lock held bit in the current locks held string, 

PSACLHS. 

4 IEAVELK sets a return code of zero in register 13. 

5 If any super bits are on in the field PSASUPER or if 
the caller of this service owns any other spin locks, 

or the CPU lockword is greater than zero, IEAVELK 
returns to the caller in a disabled state. 


Label 

CPUREL 
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Diagram SUP-19. Releasing the CPU Lock 0EAVELK) (Part 4 of 4) 


Extended Description Module Label 

6 IEAVELK returns to the caller In an enabled state. 

7 I EAVELK sets a return code of four in register 13 
indicating that the lock to be freed is not owned 

by the caller. 

Recovery Processing: 

Lock recovery processing Is described in the diagram 
"Address Space Verification Processing IEAVELCR, 

IEAVELKR, and IEAVEVRR". 

The FRR routine for spin lock manager, ELKFRR, is an 
entry point within I EAVELKR. 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 



SUP-164 


Diagram SUP-20. Spin Lock Repair Routine (IEAVELKR) (Part 1 of 12) 
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Diagram SUP-20. Spin Lock Pepair Routine (IEAVELKR) (Part 2 of 12) 

Extended Description Module Label 

The spin lock repair routine is called as follows: 

• By IEAVESAR (the Supervisor Analysis Router) due to 
SLIH mode processing by RTM or due to a restart for 
system diagnosis and repair via the Restart FLIH. 

• By IEAVTRT1 due to non-home mode DAT error. 

The spin lock repair routine correlates the current locks 
held string (PSACLHS) to the spin lockword with the 
assumption that a double error has not occurred. It ensures 
that a valid PSACLHS exists with respect to the spin lock- 
words. For spin locks, the lockword contents are always 
assumed to be correct. There are cases where the spin lock 
routine alters the PSACLHS, while in others, it may correct 
a lockword. 

1 Spin lock repair refreshes system critical fields needed 
to successfully complete lock repair processing. 

2 If the entry code in register 0 is zero, then a restart for 
system diagnosis and repair interrupt occurred. For 

this type of restart, repair and refresh processing is done, 
then the interrupted process is resumed at the next 
sequential instruction. 

3 IEAVELKR checks the super bits and compares the 
interrupt PSW address to the beginning and end of 

spin lock manager (IEAVELK) and suspend lock manager 
(IEAVESLK). If either lock manager is executing at the 
time of interrupt, then IEAVELKR returns to the caller 
without doing lock repair. (Since the obtain/release of a 
lock may be partially complete, lock repair could clean up 
lockword and indicators if allowed to process.) 

4 RTM (IEAVTRT1) calls lock repair for non-home 
mode DAT errors. If the first word of the parmlist is 

zero, RTM is the direct caller of lock repair. If RTM is the 
caller, lock repair must do additional setup processing prior 
to repairing locks. 
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Diagram SUP-20. Spin Lock Repair Routine (LEAVELKR) (Part 4 of 12) 

Extended Description Module Label 

5 Spin lock repair validates and refreshes required 
additional fields in the PSA. These fields are validated/ 

refreshed if the caller is IEAVESAR. Thus, this processing 
is only required if called by RTM directly. 

6 IEAVELKR establishes recovery for the lock repair 
function. This recovery is required to clear recursive 

processing bit (SCWELKRF) that indicates to IEAVESAR 
that lock repair is processing as a result of direct call by 
RTM. This presents IEAVESAR from reinvoking lock 
repair. 

7 I EAVELKR establishes addressability to the pseudo 
SDWA. This area is cleared to zero. The pseudo 

SDWA is used as an area for logging repair data. 

8 I EAVELKR initializes the pointer to the VRA in the 
pseudo SDWA. The lock repair function uses the 

VRA area to log information concerning lockword repairs 
and the current lock held string (PSACLHS). 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 




















LY28-1765-0 (c) Copyright IBM Corp. 1987 Method of Operation SUP-169 


Diagram SUP-20. Spin Lock Repair Routine (IEAVELKR) (Part 6 of 12) 

Extended Description Module 

9 Validates the CPU lock. 

e If an error is found, it logs the repair information 
in the VRA portion of the pseudo SOWA. 

e If the lockword contains a zero count, set the current 
locks held string ownership bit to zero. 

e If the CPU lockword contains a negative value, resets 
the lockword and the current locks held string owner¬ 
ship bit to zero. 

• If the CPU lockword contains a non-zero positive 
value, sets the current locks held string ownership 
bit to one. 


Label 
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Diagram SUP-20. Spin Lock Repair Routine (IEAVELKR) (Part 7 of 12) 
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10 Validate the shared/ 
exclusive locks. 

a) If the lockword is 
zero, reset the locks 
held string ownership 
bits. 

b) If the lockword is 
nonzero, reset the 
reserved nonzero 
bits to zero. 


c) Reset any ownership 
bits which represent 
offline processors to 
zero. 

d) If this processor owns 
the lock, ensure that 
the locks held string 
ownership bit is on. 

e) If this processor does 
not own the lock, ensure 
that the locks held string 
ownership bit is off. 

f) If all the shared/exclusive 
locks are not processed. 
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Diagram SUP-20. Spin Lock Repair Routine (IEAVELKR) (Part 8 of 12) 


Extended Daacription Modula Labal 

10 Validates the shared/exclusive locks. If an error Is 

found, it logs the repair information in the VRA 
portion of the pseudo SDWA. 

a) If the shared/exclusive lockword contents Is 
zero, resets the ownership bit in the locks 
held string to zero and continues at step 4e. 

b) If any reserved bits are nonzero in the lockword, 
resets them to zero. 

c) Interrogates the CPU alive mask (CSDCPUAL) to 
determine which processors are currently on¬ 
line. Uses this information to correlate the 
setting of the ownership bits in the shared/ 
exclusive lockword. If the ownership bit is on 

in the lockword and it is off in the CPU alive 
string, resets the ownership bit in the lockword 
to zero. 

d) If this processor's ownership bit is on in the lock- 
word, unconditionally updates the locks held 
string to reflect ownership. 

e) If this processor does not own the lock, sets the 
locks held string ownership bit to zero. 

f) Repeats step 10 until all the shared/exclusive 
locks are processed. 
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Diagram SUP-20. Spin Lock Repair Routine (IEAVELKR) (Part 9 of 12) 
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Diagram SUP-20. Spin Lock Repair Routine (IEAVELKR) (Part 10 of 12) 


Extended Description Module Label 

11 Validates single and multiple level spin locks, if an 

error is found, it logs the repair function in the VRA 

portion of the pseudo SDWA. 

a) If the lockword contents are zero, no processors 
own the lock. Resets the current locks held string 
ownership bit on the current processor to zero. 

b) The range of valid values in the lockword is 40 
through 4F, inclusive. If anything else is found 
in the lockword, resets the lockword to zero and 
unconditionally resets the current locks held 
string ownership bit on the current processor to 
zero. 

c) If the current processor's CPU ID is found in the 
lockword being validated, sets the current locks 
held string ownership bit to one. 

d) If the lockword contains a valid nonzero processor 
ID and does not contain the current processor ID, 
interrogates the CPU alive mask (CSDCPUAL) to 
determine which processors are online. Use this 
information to determine if the processor ID in 

the lockword represents an online processor. If not, 
resets the lockword to zero. 

e) Repeats the validation process for each spin lock. 

12 IEAVELKR saves the contents of PSACLHS before 

beginning spin lock validation. If this field was 

updated, it logs the old and new values in the VRA portion 

of the pseudo SDWA. 
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Diagram SUP-20. Spin Lock Repair Routine (IEAVELKR) (Part 11 of 12) 
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Diagram SUP-20. Spin Lock Repair Routine (IEAVELKR) (Part 12 of 12) 

Extended Description Module Label 

13 Validates the suspend lock environment via a call to 
the suspend lock repair routine (IEAVESLR). 

14 Checks bit SCWELKRT. It the bit is not on, then it 
returns to the caller. If the bit is on, it continues at 

the next step. 

15 Deletes the established recovery if the caller was RTM. 

Then it returns to the caller. 


I- 3 
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Diagram SUP-21. Spin Lock Repair Routine (IEAVELKR) (Part 1 of 2) 


From RTM during FRR processing 
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Diagram SUP-21. Spin Lock Repair Routine (IEAVELKR) (Part 2 of 2) 


Extended Description Module Label 

The spin lock repair FRR routine (ELKRFRR) receives 
control due to an unexpected error occurring during the 
lock repair function. The primary function of the recovery 
routine is to dear the bit SCWELKRF. This bit indicates 
that lock repair was called directly by RTM. This bit is 
tested by the supervisor analysis router (IEAVESAR) to 
prevent recursive entry into lock repair. SCWELKRF must 
be cleared in an error situation in order to allow the router 
to continue to perform its repair/refresh function. 

1 Establishes module addressability and establishes 
addressability to SDWA and VRA. 

2 Clears the bit used to indicate repair was invoked 
directly by RTM due to non-home mode DAT error. 

3 Logs diagnostic information in the SDWA and VRA. 

4 Uses the SETRP macro to indicate to RTM to con¬ 
tinue with termination. Returns to RTM. 


I 
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Diagram SUP-22. Spin Lock Manager FRR Routine (BEAVELKR) (Part 1 of 2) 
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Diagram SUP-22. Spin Lock Manager FRR Routine (IEAVELKR) (Part 2 of 2) 

Extended Description Module Label 

The spin lock manager FRR routine receives control if an IEAVELKR ELKFRR 
error or restart interrupt occurs and the spin lock manager 
(IEAVELK) has set an FRR. 

1 ELKFRR establishes module addressability and also 
establishes addressability to SDWA and VRA. 

2 ELKFRR logs information in the SDWA and VRA. 

It indicates (via SETRP macro) to record the logged 

information. 

3 If the error was a restart interrupt and it occurred 
while the spin lock manager (IEAVELK) was in a valid 

spin (LCCASPhM), ELKFRR issues a SETRP macro to 
inform RTM of the valid spin and returns to RTM. Other¬ 
wise, continue with the next step. 

4 ELKFRR determines if the system is in a known state 
(SRB mode, task mode, or supervisor system mode) 

by checking the LCCASRBM bit, the PSATOLD field, and 
the PSASUPER bits. If the system is in a known state, 

ELKFRR issues a SETRP macro to request percolation to 
the next FRR. If the system is in an unknown state, 

ELKFRR issues a SETRP requesting retry at entry point 
IEAODS in the dispatcher. 
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Diagram SUP-23. Program Check First Level Interrupt Handler (IEAVEPCO and 1EAVEPC) (Part 2 of 14) 

Extended Description Module Lebel Extended Description Module Label 


Alter a program check occurs, the program check first level 
Interrupt handler (FLIH) receives control from the program 
check new PSW. The program FLIH determines the program 
check type and routes control to the appropriate second 
level interrupt handler to process it. The program FLIH is 
made up of two modules, IEAVEPCO, which executes with 
DAT disabled end without virtual addressing, and IEAVEPC, 
which executes with DAT enabled. While performing the 
program FLIH functions, the two modules pan control back 
and forth using an LPSW instruction. This diagram describes 
the program FLIH as a whole, and notes in the extended 
description which module is actually performing the function 
being described. In general. If the program interrupt is recur¬ 
sive, IEAVEPCO handles it. Otherwise, IEAVEPCO establishes 
a recovery environment, saves the caller's registers and 
interrupt information, and gives control to IEAVEPC to 
finish processing the interrupt. 

1 The PSAPCFUN word contains recursion indicators. If IEAVEPCO IEAVPCEP 
it is not zero, or If the program FLIH super bit (PSAPI) 

is on, the interrupt is recursive. IEAVEPCO branches to 
label RECURSN to handle It. This processing Is described 
in steps 10-12. 

2 To establish recovery, IEAVEPCO saves the current 
FRR stack address and makes the program FLIH's 

FRR stack the current one. IEAVEPCO also sets the 
PSAPI bit and saves the current CPU timer value for 
calculating job step timing later. 


4 IEAVEPCO saves in the LCCA tha interrupted pro- IEAVEPCO 
gram's registers, old PSW, instruction length code, 
interrupt code, translation exception address, and cross 
memory control registers 3 end 4. It then enables DAT 
and transfers control to tha DAT-on section of the program 

FLIH (IEAVEPC). IEAVEPC traces all Interrupts except IEAVEPC IEAQPK00 
PER and space switch events. These are not traced until 
later, after the program FLIH/SLIP Interface (lEAVTPER) 
has been called. The program FLIH traces PER or space 
switch events then only If lEAVTPER indicates that the 
Interrupted program is to be terminated. When the Inter¬ 
rupted program Is to be redispatched, the PER or space 
switch Interrupt is not traced. 

IEAVEPC system traces alt non-recursive program 
interrupts, except monitor call interrupts, via the 
PTRACE macro instruction. All non-recursive 
program interrupts are GTF traced via the HOOK 
macro instruction. 


3 If the program interrupt code indicates a trace interrupt, 
IEAVEPCO calls the trace SLIH (IEAVETIH) to handle 
the interrupt. 

• Saves the interrupted program's registers in LCCAPGR4. 

• Calls IEAVETIH to handle the interrupt. 

• After the trace interrupt has been handled, returns con¬ 
trol to the interrupted program. 
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Diagram SUP-23. Program Check First Level Interrupt Handler 0EAVEPCO and IEAVEPC) (Part 3 of 14) 
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Diagram SUP-23. Program Check First Level Interrupt Handler 0EAVEPCO and IEAVEPC) (Part 4 of 14) 

Extended Description Module Label 

5 If the program interrupt code Indicates a PER or space IEAVEPC 
switch Interrupt occurred. IEAVEPC calls the program IEAVTPER 
FLIH/SLIP interface modulo (IEAVTPER). IEAVTPER calls 
either the space switch handler (IEAVTSSH) or the SLIP 
action processor (IEAVSTLP) to handle the Interrupt. (See 
the IEAVTPER, IEAVTSSH, and IEAVTSLP diagrams for 
more information.) After IEAVTPER returns, IEAVEPC 
determines if the Interrupt was a valid PER or space switch IEAVEPC 

interrupt. It Is not valid when: 

• I EAVTPER's return code Is nonzero. 

• The interrupt occurred when a space switch event was 
attempted in an Invalid crass memory environment. 

Specifically, the interrupt occurred when a routine 
tried to transfer control (using a PT instruction) to an 
address space after the |ob step had been terminated. 

In either of these cases, IEAVEPC traces the event as IEAVEPC 

described In step 4, and calls RTM to terminate the 
Interrupted unit of work. 

After IEAVTPER successfully processes a valid PER or IEAVEPC 

space switch interrupt, IEAVEPC: 

• Restores the interrupted program's registers and PSW 
from values saved In the LCCA, and restores the 
CPU timer from the PSA 

• Deletes the program FLIH's recovery routine by restoring 
the FRR stack pointer to make the previous FRR stack 
current 

• Clears the PSAPI recursion indicator 

• Returns to the interrupted program 

Q If the program interrupt coda indicates a monitor IEAVEPC 

call only (PER is not also indicated), IEAVEPC 
already processed the interrupt when it called GTF to % 

trace it in step 4. If the interrupt code Indicates that a 
PER interrupt also occurred, IEAVEPC calls IEAVTPER 
to handle it. See step 6 for a description of how this Is 
done. 
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Diagram SUP-23. Program Check First Level Interrupt Handler (IEAVEPCO and IEAVEPC) (Part 6 of 14) 

Extended Description Module Label Extended Description Module 


7 When processing a page or segment fault. IEAVEPC IEAVEPC 

first determines if the program check PSW is disabled. 

If so. the page fault is invalid. IEAVEPC calls RTM to 
terminate the interrupted program. 

If the interrupted program is a task and has a page fault SPIE 
or ESPIE exit specified, the page fault SPIE/ESPIE routine 
(IEAVSSPF) is called to handle the exit. 

• If there is no SPIE/ESPIE exit allowed, or if it is busy. IEAVESPI IEAVSSPF 
IEAVSSPF returns a code of X*04‘ which causes IEAVEPC 

to call RSM to handle the page fault. 

• If there is a SPIE/ESPIE exit. IEAVSSPF returns a code 
of X'08' which causes IEAVEPC to give control to the 
exit with the registers and PSW updated by IEAVSSPF. 

• If IEAVSSPF encountered an error referencing the 
SPIE/ESPIE control blocks, a return code of X'OC* is 
returned which causes IEAVEPC to call RTM to 
terminate the task with a code of X'6FC f . 


|f a SPIE/ESPIE routine is not provided or if it is busy. 

IEAVEPC calls the paging supervisor (RSM) at entry point 
IARFPAGE for page faults and entry point IARFSEG for IARFS 

segment faults. Determines how IEAVGPC exits from IARFS 

page or segment fault processing by using the return code 
from RSM. 

Return Action taken 
Code 

0 I/O Is required to resolve the page fault. RSM 
called the supervisor STOP/RESET routine 
(IEAVESRT) to suspend the Interrupted program. 

(See the IEAVESRT diagram for more information.) IEAVEDSO 
IEAVEPC gives control to the dispatcher 
(IEAVEDSO) at entry point IIEA0DS1A. 

4 No paging I/O is required. Either the real storage 
frame containing the page was reclaimed, or a valid 
page was referenced for the first time. IEAVEPC 
returns control to the interrupted program. 

8 The page was not valid. IEAVEPC treats the 

interrupt as a protection exception and continues 
processing at the next step. 

12 An internal error occurred In RSM. IEAVEPC calls 
RTM to terminate the interrupted program with a 
code of X'028*. 
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Diagram SUP-23. Program Check First Level Interrupt Handler (IEAVEPCO and IEAVEPC) (Part 8 of 14) 

Extended Description Module Label 

8 When processing a vector operation exception IEAVEPC VECEXCP 

interrupt, IEAVEPC calls the vector second level 
interrupt handler. IEAVEPC uses the return code in 
register 15 to determine how to exit from vector 
operation exception handling. 

Return Code Action Taken 

X'OO' The vector SLIH successfully set up the VSRETURN 

task's vector environment and indicated 
that the task should be redispatched 
immediately. IEAVEPC returns control 
to the interrupted unit of work. 

X'04' The vector SLIH successfully set up the VSEXIT 

vector environment for the task, but 
determined that either (1) the current 
processor Is not eligible for vector work or 
(2) the vector SLIH suspended the 
interrupted unit of work and suspended 
an SRB to complete the creation of the vector 
environment. 

IEAVEPC exits to the dispatcher at entry 
point IEA0DS1A. 

X'08' The vector SLIH was unsuccessful in setting VSERROR 

X'OC' up the vector environment for the interrupted 

work unit 

• If a PER interrupt was presented with the 
vector operation exception, IEAVTPER Is 
called. 

IEAVEPC calls RTM to terminate the 
Interrupted unit of work with a completion 
code of X'09F\ The associated reason code 
from the vector SLIH is also passed to RTM. 
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Diagram SUP-23. Program Check First Level Interrupt Handler (IEAVEPCO and IEAVEPC) (Part 10 of 14) 

Extended Description Module Label Extended Description Module 


9 If there was a PER interrupt along with the program IEAVEPC 
check, IEAVEPC calls IEAVTPER to handle it. Step 4 IEAVTPER 
describes how this is done. IEAVESPI celts the SPIE SLIH |EA VESPI IEAVSPPF 

(IEAVSPPF) to determine if an SPIE or ESPIE exit is in 
effect for the interrupted work unit. 

o If there is an SPIE/ESPIE exit, I EAVSPPF returns a IE A VEG LU IEAODS 

return code of X '04' which causes IEAVEPC to 
branch to the dispatcher I EAODS entry point. 

o If there is no SPI E/ESPI E exit, I EAVSPPF 
returns X *08* which causes IEAVEPC to exit 
to RTM via the CALLRTM macro. 


Recursive Interrupt processing: 

IEAVEPCO provides six levels of recursive Interrupt lEAVEPCO 

routines (PROGCK1, PROGCK2, PROGCK3, PROGCK4, 

DATERR, and LOADWAIT). When an recursive interrupt 
occurs while a previous one is being handled, IEAVEPCO 
gives control to the next higher level routine. IEAVEPCO 
keeps track of the recursion level in the program FLIH 
recursion word (PSAPCFUN). Multiple levels of routines 
are necessary to detect all types of DAT errors (two 
recursive program Interrupts In the same address space). 


*|0 When a recursive Interrupt occurs, IEAVEPCO checks 
for special types of interrupts: 

• If a PER or space switch interrupt occurred, IEAVEPCO 
turns off the PER enabled mask in the resume PSW and 
returns to the interrupted program with PER disabled. 

• If a trace interrupt causes the recursion, I EAVEPCO 
saves the interrupt registers in LCCAPGR4 and calls 
the trace SLIH (IEAVETIH). After the SLIH runs, 
returns control to the interrupted program. 

When the recursive level Is not one of the above special 
cases, IEAVEPCO gives control to the appropriate level 
routine. Stepl 1 describes how first recursive interrupts 
are handled; step 12 describes higher level recursion 
processing. 


Label 
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Diagram SUP-23. Program Check First Level Interrupt Handler (IEAVEPCO and IEAVEPC) (Part 12 of 14) 

Extended Description Module Label 

11 The way IEAVEPCO processes a recursive interrupt IEAVEPCO 
that occurred while handling an initial program interrupt 

depends on the types of interrupts involved: 

• If a monitor call occurred while processing an initial 
page or segment fault, IEAVEPCO saves the interrupted 
program's registers in the LCCAPGR3 field and cross 
memory control registers 3 and 4 in the LCCAPXM3 
field. IEAVEPC calls GTF to record the event, then 
returns control to the program that issued the monitor 
call. 

• For all other recursive interrupts IEAVEPCO saves the 
program interrupt status in the LCCAPRG1 field. The 
interrupt code and PSW are saved in LCCAPIC1 and 
LCCAPPS1. If then passes control to IEAVEPC, which 
traces the recursive interrupt (described in step 4) 

and calls RTM to initiate recovery for the interrupted 
program. 
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Diagram SUP-23. Program Check First Level Interrupt Handler (IEAVEPCO and IEAVEPC) (Part 13 of 14) 
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12 Process a recursive Interrupt 
that occurs while handling 
a previous one. 

• If It is not a OAT error 


• If a DAT error occurred 




• If a recursive error occurred 
while processing a OAT 
error 


13 Clear program F LI H 
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indicators, then restore 
the saved FRR stack 
pointer. 
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Diagram SUP-23. Program Check First Level Interrupt Handler (IEAVEPCO and IEAVEPC) (Part 14 of 14) 


Extended Description Module Label 

12 Program Interrupts that occur while processing pre¬ 
vious recursive program interrupts are considered 
errors and, except for DAT errors, are handled in much the 
same way. Unless a DAT error has occurred, tha tygher level 
routine (PROGCK2, PROGCK3, or PRGGCK4): 

• Saves tha interrupted program’s primary ASID in the PSA 

• Refreshes the PSA fields necessary for continued system 
operation 

• Saves the interrupted program’s registers in the LCCAPRG1 
field and the cross memory status in the LCCAPXM1 field. 

Saves the recursive interrupt code and PSW in LCCAPIC1 
and LCCAPPS1, respectively. DATERR 

• Enables DAT 

• Traces the interrupt via system trace 

• Calls RTM to initiate recovery for the interrupted program 

Before doing the preceding, PROGCK3 and PROGCK4 com¬ 
pare the primary ASID (PASID) at the time of the interrupt 
with the previously saved PASID. A match indicates that a 
DAT error has occurred in that address space. When this 
happens, IEAVEPCO: 

• Sets the cross memory control registers to address the 
master scheduler’s address space 

• Refreshes the PSA fields necessary for continued 
system operation 

• Saves the interrupted program’s registers and cross 
memory status in the LCCAAPGR1 and LCCAPXMI 
fields. Saves the recursive interrupt code and PSW 
in LCCAPIC1 and LCCAPPS1, respectively. 

• Enables DAT 

• When system trace is active, traces the interrupt 

• Calls RTM to terminate the failing address space 


PROGCK2, 
PROGCK3, or 
PROGCK4 


Extended Description Module Label 

When a recursive interrupt occurs during DAT error process* 
ing, IEAVEPCO terminates the system. It first changes the 
program check and restart new PSWs to disabled wait PSWs 
so that any future recursive interrupts will result in the hard 
ware loading a disabled wait PSW. IEAVEPCO then calls 
IGFPWAIT. to terminate the system. IGFPWAIT loads the 
disabled wait PSW with wait code X’014* and issues termi¬ 
nation message IEA999W. 

13 The program FLIH has a retry routine to which the IEAVEPCR IEAVEPCR 
supervisor FRR (IEAVESPR) will retry if the program 
FRR stack Is current. IEAVEPCR clears the program FLIH 
indicator (PSAPOand the F LIH’s recursion indicators 
(PSAPCFUN). The program which received the program 
interrupt is abended with an X ’4FC* completion code. 


LOADWAIT 


IGFPWAIT 
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Diagram SUP-24. PURGEDQ Processing (IEAVEPDO) (Part 1 of 2) 
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Diagram SUP-24. PURGEDQ Processing (IEAVEPDO) (Part 2 of 2) 

Extended Description Module Label 

Supervisor services use PURGEDQ to cancel SRBs that, 
for various reasons, should not be executed. The schedule 
function places SRBs on a queue; and these SRBs execute 
asynchronously to the schedule request PURGEDQ cancels 
SRBs, when necessary. 

1 PURGEDQ terminates callers that have invalid IEAVEPDO IGC123 

parameter lists. 

2 PUhGEDQ will wait for SRB completion by using the 
STATUS STOP SRB function. STATUS STOP mures 

that SRBs dispatched to the address space have completed. 

PURGEDQ bypasses the waiting operation If the address 
space specified by the ASID- parameter on the 
PURGEDQ macro is not the current address space. 

3 PURGEDQ dequeues the SRB by: 

a. Locating the dispatcher queue to be searched. 

PURGEDQ will search the following queues: 

a Global service management queue (IEAVGSMQ) 
a Global service priority list (IEAGSPL) 

Local service management queue (IEALSMQI 

a The local SMQ for the address space specified 
in the ASID parameter (ASCBLSMQ). 

a The local SPL for the address space specified in 
the ASID parameter (ASCBLSPL). 

b. Scanning the queues searching for a match on the 
specified Inputs. 

c. Dequeueing those SRBs that match the Inputs. 


Extended D«criptkxi 


Module 


Label 


r- a 


4 PURGEDQ starts SRBs via STATUS, if they had 
previously been stopped (in step 2). 

5 PURGEDQ routes control sequentially to the RMTR 
for each dequeued SRB. When 8(1 RMTR routines 

have been called, PURGEDQ returns via the address 
passed In register 14 by the caller. This address is 
established by SVC FLIH to be entry to the exit 
Prolog (IEAVEEXP). 
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Diagram SUP-25. PURGEDQ Recovery (IEAVEPDR) (Part 1 of 2) 
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Diagram SUP-25. PURGEDQ Recovery (IEAVEPDR) (Part 2 of 2) 

Extended Description Module Label 

1 PURGEDQ FRR is entered if an error occurred during 1EAVEPDR IEAVEPDF 
the queue scanning or updating of the PURGEDQ 

mainline. The FRR attempts to verify and correct the SPL 
queues (since bad data on those queues may be causing the 
errors) by invoking a secondary entry point to the SCHEDULE 
recovery, IEAVESQV, which performs verification and 
correction of those queues. 

2 Upon receiving control back from that routine, the 
FRR issues the SETRP macro to set fields in the 

SDWA for recording information and to indicate that the 
error should be processed by the PURGEDQ ESTAE 
routine. It then returns to RTM, which percolates the error 
to the ESTAE. 

3 The PURGEDQ ESTAE routine receives control if an IEAVEPDR IEAVEPDE 
error occurred anywhere in the PURGEDQ mainline 

function. It performs cleanup to ensure correct system 
status. It starts SRBs, via STATUS, if they had been stopped 
when the error occurred. 

4 If en error occurred in an RMTR routine, ESTAE 
records fin the SDWA) the address of the SRB that 

the RMTR was cleaning up. 

5 The PURGEDQ ESTAE routine determines if the 
PURGEDQ function should be retried. It sets up for 

the retry to the beginning of the PURGEOQ mainline if either 
this error occurred for the first time during this invocation 
of PURGEOQ or if the error occurred during the processing 
of an RMTR routine. If neither of these conditions is true, 
then the error will be processed by the caller of PURGEDQ. 

6 This retry entry point sets up for the mainline entry IEAVGPDR IEAVEPDS 
point of IEAVEPDO. 
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Diagram SUP-26. Queue Verification (IEAVEQVO) (Part I of 4) 
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Diagram SUP-26. Queue Verification (IEAVEQVO) (Part 2 of 4) 


Extended Description Module Label 

^ IEAVEQVO verifies and corrects queue structures. IEAVEQVO 
It performs validity checking of input parameters to 
minimize the possibility of the caller incorrectly coding the 
interface. Queue verification (IEAVEQVO) returns control to 
the caller immediately with a return code of 24 in register 15 
if it detects invalid input parameters. 

Setting bit QVPLEXT and initializing the appropriate pointer 
field in the parameter list, permits the user to specify an 
Extended Queue Verifer Parameter list (QVPLXVPL). The 
pointer fields for each queue type are QVPLXPL1, 

QVPLXPL2, and QVPLXPL3. It contains the address of a 
24-byte area used for processing special options. 

2 Queue verification corrects queues as follows: 

• Single-threaded queues with header only: Since this type 
of queue contains no duplicate information, queue recon¬ 
struction is not possible. Therefore, if any errors in the 
chaining are found, the queue is truncated at the point of 
error. 

• Single-threaded queues with header and trailer: For this 
type of queue, the end of the queue found by scanning the 
forward chain might not coincide with the value in the 
trailer. In general, if the trailer contains the address of a 
queue element, that element is considered the "real" last 
element. 

If the header has been destroyed, queue verification tries to 
salvage the element pointed to by the trailer. 

If the trailer has been destroyed, it is restored from the 
forward chain. 

If a forward chain pointer has been destroyed, all the 
previous elements on the chain will be connected to the 
element pointed to by the trailer. 

• Double-threaded queues: If the header and trailer contain 
addresses of elements, those elements are considered the 
real first and last elements, respectively. 

As long as the forward chain is valid, it has precedence over 
the backward chain. (When scanning the forward chain, 
the next element should always point back to the current. 

If it does not, the backward pointer will be corrected.) 


Extened Description Module Label 

If the header is bad, it is restored from the backward chain. 

If the trailer is bad, it is restored from the forward chain. 

If either the forward or backward chain Is bad, one is 
reconstructed from the other. If both are bad, they are con¬ 
nected at their last valid points. 

• All types of queues: The queue verification detects circular 
queues. The last element found before the queue repeats is 
considered the last good element on the chain. 

All elements that contain bad data, as defined by a return 
code of 4 from the element verification routine, will be 
removed from the queue. 

• Circularity checking: Queue verification detects circular 
queues. The last element found before the queue repeats 
is considered the last good element on the chain. 

• Single-threaded queues: If the caller of queue verification 
uses the extended queue verification parameter list, the 
caller can set bit QVPLXM and specify a maximum number 
of expected elements in QVPLXMAX. IEAVEQVO 
suppresses the circularity check until the count of elements 
exceeds this maximum. This option significantly reduces 
the path length to verify a correct queue. 

• Double-threaded queues: It is logically impossible for two 
elements of a double-threaded queue to have a circular 
relationship if the forward and backward pointers agree. 

Therefore, when scanning the forward chain, if the next 
element points back to the current, the circularity check is 
supressed. Similarly, when scanning the backward chain, if 
the next element points forward to the current, the 
circularity check is supressed. 

• Removal of elements with bad data: The queue is scanned 
one time to verify the structure of the queue and if this 
scan Is not perfect, the queue is scanned a second time to 
verify the data within the elements. 

A return code of 8 from the event verification routine (EVR) 
indicates that the pointer to the current element is invalid 
and the structure of the queue is damaged. A return code 
of 4 from the EVR indicates that the current element 
contains bad data. All elements that contain bad data will be 
removed from the queue. If the first scan of the queue is 
perfect, the second scan is supressed. 


r* 3 
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Diagram SUP-26. Queue Verification (IEAVEQVO) (Part 3 of 4) 
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Diagram SUP-26. Queue Verification (IEAVEQVO) (Part 4 of 4) 

Extended Description Module 

3 All errors encountered are recorded In the queue 
verification output data area (QVOD). The QVOD 
maps into the recording area of the SDWA. Generally, the 
following information will be supplied. 

• Error code, describing the specific error. 

• If an element had bad chain information, then the address 
of the element, the old (bad) chain information, and the 
new (corrected) information are recorded. 

• If an element was removed because it contained bad data, 
than the address of the element, the address of the previous 
element on the queue, and the address of the next element 
on the queue are recorded. 

If the caller of queue verification is using the extended queue 
verification parameter list, a count of good elements may be 
requested by setting the QVPLXC bit. Before returning to its 
caller, IEAVEQVO stores the count of good elements into 
QVPLXCIMT. 


Label 
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Diagram SUP-27. Restart Interruption Handler (TEA VERES) (Part I of 2) 
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Diagram SUP-27. Restart Interruption Handler (IEAVERES) (Part 2 of 2) 


Extended Description Module Label 

The restart interruption handler OH) routes control to 
recovery termination after the operator uses the system 
restart function or a routine issues a restart SIGP instruction. 

1 The restart 1H ignores recursive entries by giving IE AVER ES IEAVRSTR 

control back to the interrupted program. Otherwise, 

normal processing continues. 

2 The restart IH: 

o Saves the general registers in the LCCARSGR field 

• Saves cross memory control registers 3 and 4 in the 
LCCARXMR field. 

3 The restart FLIH DATOFF routine refreshes the IEAVEREO IEAVEREO 
machine-check new PSW and the program new PSW. 

4 The restart interruption handler extension IEAVEREX IEAVEREX 

(IEAVEREX) will use the specified system restart 

function reason (on the system control operator's frame) 
to determine further processing, interfacing with 
CALLRTM TYPE-RESTART, if necessary. The exten¬ 
sion routine will acquire and release the restart resource 
as needed. 

Recovery Processing 

The restart FRR (functional recovery routine) clears the IEAVERER IEAVERER 

restart Interruption indicator in PSARECUR, sets the restart 

resource in the CVTRSTWD field of the CVT to zero, and 

points the FRR pointer (PSACSTK) to the normal FRR 

stack. It then terminates the program executing when the 

interruption occurred with a X'BFC completion code. 
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Diagram SUP-28. Restart Interruption Handler Extension (IEAVEREX) (Part 1 of 4) 
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Diagram SUP-28. Restart Interruption Handler Extension (IEAVEREX) (Part 2 of 4) 


Extended Description Module Label 

The restart interruption handler (IH) extension 
(IEAVEREX) processes the restart interrupt called by 
IEAVERES. Depending on the system restart function 
reason, IEAVEREX either terminates the interrupted program 
and invokes the necessary recovery routines (0) or performs 
high-level system diagnosis not related to the work cur¬ 
rently being processed (1). 

1 IEAVEREX saves the cross memory status of the inter¬ 
rupted program and sets this address space to the home 

address space (PSAAOLD). 

2 IEAVEREX checks the CVTMSFCB field to see if 

the MSSF is available. IEAVER EX checks the PCCACPID 
field of all processors to determine that no processor Is running 
under VM. IEAVEREX obtains the restart reason by an MSSFCALL 
DIAGNOSE instruction issued by MSSFCALL SVC routine 
through branch entry IEAVMSF1 or IEAVMSF2. IEAVEREX 
uses IEAVMSF4 if the interrupted routine is enabled for EMS, 

MFA and MSSF external interrupts and use as IEAVMSF2 in 
all other cases. If the MSSFCALL fails, IEAVEREX issues 
message IEA502A via module IEEVDCCR to prompt the 
operator for a restart reason value. I EAVEREX stores the 
operator-entered value of the system restart function in the 
system restart processor-related work area. 

3 If the system restart function reason is zero, I EAVEREX 
performs as follows: 

• The restart resource must be obtained before entry to 
RTM. If the restart lock (CVRSTWD) equals zero, 

or is owned by RTM on this CPU (the CPU ID and 
function code 'RF') or is being passed to IEAVEREX 
by RTM (the CPU ID and function code 'RP') IEAVEREX 
acquires the restart resource (set to the CPU ID and 
function code 'RF'). If the resource cannot be acquired, 

IEAVEREX resumes the interrupted program by return¬ 
ing to IEAVERES. 

• IEAVEREX issues message IEA500A to the operator IEEVDCCR 

via module IEEVDCCR and waits for a reply of 

"ABEND" or "RESUME". 


Extended Description Module Label 

• If the operator replied "ABEND" or if the operator 
communications failed, IEAVEREX restores the FRR 
stack and goes to RTM (CALLRTM TYPE= RESTART). 


• If the operator replied "RESUME", IEAVEREX ends 
further restart processing and restores the cross 
memory status. IEAVEREX then returns to 
IEAVERES. 

• IEAVEREX releases the restart resource if acquired. 
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Diagram SUP-28. Restart Interruption Handler Extension (IEAVEREX) (Part 3 of 4) 
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Diagram SUP-28. Restart Interruption Handler Extension (IEAVEREX) (Part 4 of 4) 

Extended Description Module Label 

4 If the system restart function reason is 1, IE AVER EX 
performs the necessary system diagnostics and repair 

actions. 

• If the system is nondispatchable (CSDSYSND=1), 

IEAVEREX schedules an SRB {global, nonquiesce- 
able) in the master address space and resets the system 
status (NDISPSRB). IEAVEREX issues a Test and 
Set (TS) instruction to serialize the SRB. This allows 
the SRB routine to receive control with the local lock 
held. IEAVEREX formats the first line of message 
IEA501I. 

• IEAVEREX adds text to message IEA5011 as follows. 

— If the limitations of the WTO buffer have been 
exceeded (that is, the contents of UCMWQNR is greater 
than the contents of UCMWQLM). 

- If neither a batch Job or a timesharing user is found (for 
each active ASCB (located via the ASVT), IEAVEREX 
checks the CSCB for a batch Job (ASCBJBNI s O) or a 
timesharing user (CHTRKID«X'Or). 

• IEAVEREX notifies the operator of anything it repairs IEEVDCCR 
or diagnoses by issuing message IEA501I (via IEEVDCCR). 

• IEAVEREX serializes the global work area (including the 
SRB). The first byte of the work area is the serializing 
byte. IEAVEREX invokes the IECVRSTS routine for 

I OS functional analysis. 

5 IEAVEREX restores the cross memory environment 
using information stored in the processor-related work 

area. IEAVEREX returns to IEAVERES to resume the 

interrupted program. 
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Diagram SUP-29. Interprocessor Communications (IPC) Remote Immediate Signal Routine (IEAVERI) (Part 2 of 4) 

Extended Description Module Label Extended Description Module 


1 The remote immediate signal routine on the sending 
processor establishes the interface to cause a specific 

program to get control on a specific receiving processor. 

IEAVERI causes an emergency signal to a specified processor. 

The emergency signal SLIH (IEAVEES) on the receiving 
processor routes control to the program. 

2 IEAVERI determines the validity of the PCCA (physical 

configuration communication area) address. IfthePCCA IEAVERI IEAVERI 
address is invalid, IEAVERI ABENDS the caller with a 
completion code of X'07B' and a reason cocJ§ of X'00\ Other¬ 
wise, normal processing follows. 

3 IEAVERI returns control to the caller if the receiving 
processor is not online, with a return code of 4 in 

register 15. 

4 IEAVERI sets the request type entry point address, 

PCCA address of the receiving routine, and parameter 

address in the PCCAEMSB field of the sending processor's 
PCCA. 

5 IEAVERI sets the input values for the signal routine 
(IEAVESGP), which actually issues the SIGP instruction. 

6 | EAVESGP passes back a return code based on the 
condition code of the SIGP instruction. (See IEAVESGP.) 

IEAVERI uses this return code to determine the success 
of the signal. 

For serial or parallel requests, if the signal was successful, 

IEAVERI spins until the receiving processor clears the 
PCCAEMSI field. 


If the signal is not accepted by the receiving CPU after 
spinning for a reasonable length of time (i.e., the PCCAEMSI 
field is not cleared), IEAVERI resets the Input values for 
the signal routine and invokes IEAVESGP to reissue the 
signal. Otherwise, IEAVERI continues spinning. If the 
PCCAEMSI field is still not cleared after the second spin, 
IEAVERI calls the excessive spin notification routine 
(IEEVEXSN), which issues message IEE331Ato notify 
the operator of the spin. If the receiving processor remains 
online, IEAVERI continues to spin. If the receiving routine 
for a serial request fails, the receiving processor does not 
clear PCCAEMSI and indicates the failure (sets PCCASERF 
to one). IEAVERI abends the caller with an X'073' and a 
reason code of X'QC\ 


Label 
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Diagram SUP-29. Interprocessor Communications (IPC) Remote Immediate Signal Routine (IEAVERI) (Part 3 of 4) 
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Diagram SUP-29. Interprocessor Communications (IPC) Remote Immediate Signal Routine (IEAVERI) (Part 4 of 4) 


Extended Description Module 

7 The caller receives a return code, indicating the status 
of the request, from the remote immediate routine. 

If the requested function is successful, the return code is 
X'OO'. For a return code of X'04' the specified processor 
is not online and no signal was issued, if the processor is 
taken offline during the spin, the return code is X'14'. 

8 Indicates error information in the SQWA and VRA 
areas. 

9 Depending on the reason entered, uses the SETRP 
macro to indicate to RTM to either transfer a restart 

or to percolate. 
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Diagram SUP-30. Interprocessor Communications (IPC) Remote Pendable Signal Routine (IEAVERP) (Part 1 of 2) 
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Diagram SUP-30. Interprocessor Communications (IPC) Remote Pendable Signal Routine (IEAVERP) (Part 2 of 2) 

Extended Description Module Label 

*| The remote pendable signal routine on the sending IEAVERP 

processor establishes the interface to cause a specific 
system routine to get control on a specific receiving process¬ 
or. IEAVERP causes an external call signal to a specified 
processor. The external call SLIH (IEAVEXS) on the re¬ 
ceiving processor routes control to the program. IEAVERP 
determines the validity of the PCCA address. The remote 
pendable routine abends the caller if it finds the PCCA 
address invalid. The caller receives a X'07B' ABEND with 
an X'04* reason code. Otherwise, normal processing follows. 

2 The remote pendable routine determines whether the 
processor receiving the request is still online. Control 

goes back to the caller, with a return code of 4 in register 
15, if the receiving processor is not online. Otherwise, 
normal processing continues. 

3 Next, the remote pendable routine sets the request 
code in the PCCARPB field of the receiving processor's 

PCCA. 

4 The remote pendable signal routine sets the input 
values for the signal routine, which actually issues 

the SIGP instruction with an external call order code. 

5 The remote signal routine returns to the caller with 
the code it received from IEAVESGP in register 

15 indicating the status of the request. On return from 
the signal routine, either the signal has been sent to the 
specified receiving processor (set the return code to X'OO') 
or the receiving processor is no longer online (set the return 
code to X '04'). 
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Diagram SUP-31. SCHEDULE Processing (IEAVESCO) (Part 1 of 22) 
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Diagram SUP-31. SCHEDULE Processing (IEAVESCO) (Part 2 of 22) 

Extended Description Module Label 

This routine is entered (using a BALR) from the SCHEDULE 
macro when an enabled issuer requests that an SRB be placed 
on a local SRB queue. 

The ASCB contains a local service management queue 
(LSMCO and a local service priority list (LSPL). This 
routine determines which queue the SRB should be 
added to. 

1-3 This routine disables for I/O and external interrupts IEAVESCO IEAVESC1 
and passes control to the disabled local entry point 
(IEAVESCR) to do the schedule processing. This 
routine restores the caller's original system mask prior 
to returning control to the caller. 
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Diagram SUP-31. SCHEDULE Processing (DEAVESCO) (Part 4 of 22) 

Extended Description Module Label 

This routine is entered from the SCHEDULE macro (via 
BALR) or from IEAVESC1 (via BASR) when a disabled 
issuer requests that an SRB be placed on a local SRB queue 
or from the enabled local entry point (1EAVESC1). 

4 Save registers 12,13 and 14 In the PSAGPREG. IEAVESCO IEAVESC2 

g If the ASCB pointed to by the SRB does not contain 
a valid ASCB acronym, control will be passed to step 
10 and the caller will be abended. 

6 The SRB is added to either the ASCBLSMQ or the 
ASCBLSPL. If both queues are empty, the SRB 
Is placed on the ASCBLSPL; otherwise the SRB is 
placed on the ASCBLSMQ. 
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Diagram SUP-31. SCHEDULE Processing (IEA VESCO) (Part 6 of 22) 

Extended Description Modulo Labe) 

7 If ASCBURR (the high-order bit of ASCBLSMQ) is 
set to 1, then notify the system resource manager 
(SRM), using SYSEVENT (step 11), to swap-in the address 
space in which the SRB will run. 

g IEA VESCO invokes the memory switch service 
(IEAVEMSO) with the ASCB address that has 
ready work as input. Memory switch looks for a 
processor eligible to run the ready work. If an elig- 
ble processor is found, PS ANEW for that processor is 
updated. (Memory switch is described in the DISP 
section of the System Logic Library.) 

9 Restore the registers and return control to IE AVESC1 
or the disabled caller. 

10 Abend the caller. 
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Diagram SUP-31. SCHEDULE Processing (IEAVESCO) (Part 7 of 22) 
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Diagram SUP-31. SCHEDULE Processing (IEAVESCO) (Part 8 of 22) 

Extmdad Dwcriptksn Modal* L«M 

11 SRM (system resource manager) is notified, using 
SYSEVENT (USERRDY option), that there is 

ready work for a swapped-out address space. This will 
cause a swap-in of that address space. 

12 The saved registers 12,13 and 14 are restored 
from field PSAGPREG and control is returned 

to IEAVESC1 or the disabled caller. 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 



SUP-222 


Diagram SUP-31. SCHEDULE Processing (EEAVESCO) (Part 9 of 22) 
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Diagram SUP-31. SCHEDULE Processing (EEAVESCO) (Part 10 of 22) 

Extended Description Module Label 

This routine is entered (viaaBALR) from the SCHEDULE 
macro when an enabled issuer has requested that the SRB 
be placed on a global SRB queue, and a waiting processor 
Is detected. The SRB at this time has already been placed 
on the appropriate queue by the SCHEDULE macro. 

This routine disables for interrupts and passes control to IEAVESC0 IEAVESC3 
the disabled global entry point (IEAVESC4) to signal 
any waiting processors. 

13 This routine initially saves the caller's system mask 
in the first byte of PSASCPSW. This routine disables 

the PSW for I/O and external interrupts. 

14 

15 


This routine passes control to the SCHEDULE entry 
point, IEAVESC4. 

This routine restores the caller's registers and saved 
system mask and returns to the caller. 
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Diagram SUP-31. SCHEDULE Processing | (IEAVESCO) (Part 11 of 22 ) 


From the tfoba! SCHEDULE macro when 
running disabled and detecting a waiting 
processor or from IEAVESC3 
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Diagram SUP-31. SCHEDULE Processing (IEAVESCO) (Part 12 of 22) 

Extended Description Module Label 

This routine is entered (via a BALR) from the SCHED¬ 
ULE macro when a disabled issuer has requested that 
the SRB be placed on a global SRB queue and a wait¬ 
ing processor is detected. It can also be entered from 
the enabled global entry point (IEAVESC3) via BASR. 

In this case the SRB has already been added to the appro¬ 
priate queue by the SCHEDULE macro. 

16 IEAVESCO saves registers 13 and 14 in PSASCGR1. IEAVESCO IEAVESC4 

17 IEAVESCO issues a SIGP instruction with an 
EXTERNAL CALL order code to signal the 
waiting processor. 

18 IEAVESCO returns control to IEAVESC3 or the 
disabled caller. 
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Diagram SUP-31. SCHEDULE Processing,(IEAVESCO) (Part 13 of 22) 
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Diagram SUP-31. SCHEDULE Processing (IEAVESC0) (Part 14 of 22) 

Extended Owcription Moduli Label 

For aach SRB on tha queue the following processing to done: 

19 If the ASCB pointed to by the SRB does not contain IEAVESCS 

a valid ASCB acronym, IEAVESCO issues an 

X*076* ABEND. 

20 IEAVESOD queues the SRB to the ASCBLSMQ in 
the eddress space identified by SRB ASCB. 

21 If the eddress space to swapped out, IEAVESCO 
notifies SRM (system resources manager) of work ready 

to be dispatched to an address space already swapped-out. 

This causes an eventual swap-in of that address space. 

22 IEAVESCO invokes the memory switch service 
(IEAVEMS0) with the ASCB address that has 

ready work. Memory switch looks for a processor 
eligible to run the ready work. If an eligible processor 
is found, PSAANEW for that processor is updated. 

(Memory Switch is described In the DISP section of 
the System Logic Library J 

23 IEAVESCO receives control at entry point 
IEAVESCS when the suspend lock manager (IEAVESLK) 

finds a CML requestor on the suspend queue of a local 
lock it is releasing. IEAVESCO ensures that the SRB is 
scheduled to the appropriate ASCB and that tha target 
ASCB is valid. If the ASCB pointed to by the SRB con¬ 
tains a valid acronym, and its ASCBASID value matches 
the ASID saved at the time the SRB was suspended, 

IEAVESCO continues processing at step6. There it 
places the SRB on the appropriate local SRB queue. 

If the ASCB does not contain a valid acronym, 

IEAVESCO issues an X‘075’ abend. Otherwise, it 
gives control to the resource manager whose 
address is in the SRBRMTR field. The resource 
manager frees the SRB storage and returns to IEAVESLK. 
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Diagram SUP-31. SCHEDULE Processing (IEAVESC0) (Part 16 of 22) 


Extended Description Module Label 


Entry points IEAVESC7 and IEAVESC8 are 
entered when a global schedule macro is invoked 
and SRB queueing is not done inline as part of 
the SCHEDULE macro expansion. 

IEAVESC7 is entered from the SCHEDULE macro 
via BALR when an enabled user has requested 
that an SRB be placed on a global SRB queue. 

IEAVESC8 is entered from the SCHEDULE macro 
when a disabled user has requested that an SRB 
be placed on a global SRB queue. IEAVESC8 
can also be entered from the enabled global entry 
point IEAVESC7 via a BASR. 

24 IEAVESCO initially saves the caller's system 
mask in the first byte of PSASCPSW and 

disables the PSW for I/O and external interrupts. 

25 IEAVESC7 panes control to th« SCHEDULE 
antry point IEAVESC8. 

26 IEAVESC7 restores the caller's registers and 
saved system mask and returns to the caller. 
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Diagram SUP-31. SCHEDULE Processing 0EAVESCO) (Part 17 of 22) 
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Diagram SUP-31. SCHEDULE Processing (IEAVESCO) (Part 18 of 22) 

Extended Description Module Label 

IEAVESC8 is entered from the SCHEDULE macro via 
a BALR when the schedule macro with the disabled 
keyword was specified and inline SRB queuing is not 
done as part of the macro expansion. IEAVESC8 is also 
entered from SCHEDULE entry point IEAVESC7 via a 
BALR. 

27 IEAVESC8 saves the caller's register 13 and 14. 

28 IEAVESC8 adds the SRB to the global service 
priority list (GSPL). If there were no elements 

queued on the GSPL the 8dd will be successful. If the 
add is successful, 

• IEAVESC8 transfers SRB queued on the global service 
management queue (GSMQ) if any, to the GSPL 

• IEAVESC8 continues at step 35. 
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Diagram SUP-31. SCHEDULE Processing (IEAVESCO) (Part 19 of 22) 


Input 


Register 1 _ (SRB to be queued) 

f SRB 


SVT 



Process 


2 


29 Add the SRB onto the 

Global Service management 
queue. 


5 


Output 


SVT 



Queued SRB N 








LY28-1765-0 (c) Copyright IBM Corp. 1987 Method of Operation SUP-233 


Diagram SUP-31. SCHEDULE Processing (IEAVESCO) (Part 20 of 22) 

Extended Description Module Label 

29 The SRB is added to the GSMQ. The add function 
is retried until it is successful. 
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Diagram SUP-31. SCHEDULE Processing (IEAVESCO) (Part 22 of 22) 

Extandad Description Module 

30 Examine the processor waiting vector (SVTPWAIT) 
for waiting processors. If one is found, issue a SIGP 

external call to activate the processor. 

31 Restore the caller's registers. 

32 Return to the caller. 


Label 
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Diagram SUP-32. SCHEDULE Recovery Processing (IEAVESCR) 
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Diagram SUP-32. SCHEDULE Recovery Processing (IEAVESCR) (Part 2 of 2) 

Extended Description Module Label 

1 The schedule FRR verifies the SRB journal queue IEAVESCR SRBQV 

anchored out of the LCCASMQJ field and 

removes SRBs with bad information. The journal queue 
is used by SCHEDULE to prevent losing SRBs that are being 
processed. 

2 The schedule FRR then reschedules any SRBs remaining 
on the journal queue. 

3 The schedule FRR uses the queue verifier to verify 
SRB queues — the GSPL, then the ASCB and the LSPL 

for every address space in the system. Errors detected are 
recorded in the SDWA; elements removed are also noted in 
the SDWA. 
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Diagram SUP-33. Interprocessor Communication SIGP Routine (IEAVESGP) (Part I of 8) 
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Diagram SUP-33. Interprocessor Communication SIGP Routine (IEAVESGP) (Part 2 of 8) 

Extended Description Module Label 

The interprocessor communication SIGP routine provides 
the necessary environment and interfaces to issue a SIGP 
request. It transmits an eight-bit order code to a specified 
processor and handles all error conditions resulting from 
the execution of the SIGP instruction. 

1 Issues the SIGP instruction. 

• If a zero condition code results, returns to the 
caller. 

• If the SIGP fails, saves the condition code. 


2-3 Sets U P the 1°°P controls. If necessary, reissues the 
SIGP up to one million times. If after one million 
retries the SIGP is still unsuccessful, IEAVESGP assumes a 
problem exists and determines if the processor to be sig¬ 
nalled is still online. If not, it exits to its caller with a 
return code of X'OC* if the caller was the direct signal service 
routine; else it exits with a return code of X'04'. If the 
processor still appears to be online, a window for MFA 
interrupts is opened. If after the window has been opened 
the processor appears offline, IEAVESGP returns to its 
caller with a return code of X'OC 1 if the caller was the 
direct signal service routine; else it exits with a return code 
of X'G4'. If not, and if the ten-second time loop has not 
expired, the SIGP is retried up to one million more times.. 

If the ten-second loop has expired, IEAVESGP calls ex¬ 
cessive spin notification to inform the operator of the 
problem if the caller was not the direct signal service 
routine. 

4 If this is not the first time the SIGP instriction is 
issued, reissues the SIGP. If this is the first time, 
checks condition codes in the next step. 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 



SUP-240 MVS/XA SIL« Supervisor Control LY28-1765-0 (c) Copyright IBM Corp. 1987 


Diagram SUP-33. Interprocessor Communication SIGP Routine (IEAVESGP) (Part 3 of 8) 
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5 Check the condition code returned from the SIGP: 


If the condition code is 0 return 

to the caller. 

If the condition code is 1: 

— if the order code was "SENSE" 
return to the caller. 

— If the stored status indicates an 
equipment check and the passed 
order code was "RESTART", 
return to the caller. 

— If the stored status indicates an 
equipment check and the passed 
order code was not "RESTART”, 
reissue SIGP. 

— If the stored status indicates 
receiver check or operator 
intervening, reissue SIGP. 

— If the stored status indicates 
an external call pending, 
return to the caller. 

— For all other condition code 1 
situations, the status indicator 

was "STOPPED", "NOT READY", 
or "CHECK STOPPED". Make sure 
the processor is still online and notify 
excessive spin. 

If the condition code is 2, retry the SIGP. 

If the condition code is 3, make sure 

the processor is online and, if so, notify 

excessive spin. 



Step 13 
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► Step 6 
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Diagram SUP-33. Interprocessor Communication Routine (IEAVESGP) (Part 4 of 8) 


Extended Description Module 

5 Analyzes the condition code from the first SIGP or 
any reissued SIGP to determine the appropriate 
action. The following actions can be taken: 

• Return to the caller with a return code of: 

— 0 if the condition code=0. 

— 8 and status in register 0 if the condition code=1 
and the order code was "SENSE". 

— 8 and status in register 0 if the condition code^l, 
stored status indicates an equipment check and 
the order code was "RESTART". 

— 0 if the condition code=1 and stored status in¬ 
dicates that an external call is pending. 

• Reissue the SIGP if the condition code is: 

— 1, stored status indicates an equipment check and the 
order code was not "RESTART". 

— 1 and stored status indicates a "receiver check". 

— 1 and stored status indicates "operator intervening". 

— 2 (addressed processor is busy). 

• Determine if processor is still online and if the caller 
was IEAVERI or IEAVERP. If so, call excessive spin 
if the condition code is: 

— 1 and the status indicator^was "STOPPED", "NOT 
READY"/or "CHECK STOP". 

— 3 (addressed processor is not operational). 


Label 
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Diagram SUP-33. Interprocessor Communication SIGP Routine (IEAVESGP) (Part S of 8) 
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has been retried: 
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7 Determine if the processor being 
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• If it has gone offline, return 
to the caller. 

8 Establish recovery. Open window 
for IVIFA interrupts. 

Delete recovery. 
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9 Determine if the processor being 
signalled has gone offline: 


• If it has gone offline, return 
to the caller. 

10 Check the amount of time expired 
while the SIGP was being retried: 


Step 13 
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• If the caller was the direct 
signal service routine 
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Diagram SUP-33. Inteiprocessor Communication SIGP Routine (IEAVESGP) (Part 6 of 8) 

Extended Description Module Label 

6 Checks the number of times SIGP has been issued. 

If the number of retries is less than one million, 

reissues the SIGP. If the number of retries is one mil¬ 
lion, continues processing. 

7 Determines if the processor being signalled is still 
online. If it is not, sets a return code of X'OC' 

and returns to the caller (see step 13). 

8 If the processor is still online, opens a window for 
MFA interrupts. 

9 When the window is closed, checks again to 
determine if the processor is still online. If it 

is not, sets a return code of X'OC' and returns 
to the caller (see step 13). 

10 If ten seconds has not expired after the first one 
million retries, starts with another million retries 

of the SIGP. If ten seconds has expired and the SIGP is 
still not successful, a problem exists with the processor 
to be signalled and excessive spin notification is called. 

(Note: Excessive spin notification is not called if the 
caller of IEAVESGP was the direct signal routine 
(1EAVEDR). In that case, the last condition code re¬ 
turned from the SIGP instruction is converted to a 
return code and control returns to the caller. 
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Diagram SUP-33. Interprocessor Communication SIGP Routine (IEAVESGP) (Part 7 of 8) 
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Diagram SUP-33. Inteiprocessor Communication SIGP Routine (1EAVESGP) (Part 8 of 8) 

Extended Description Module Label 

11-12 If the processor is still online, sends the 
appropriate message code to the excessive 
spin notification routine (IEEVEXSN) to issue message 
IEE331 A. If the ACR option of the message is chosen, 
the process is over. If the option to continue the spin 
is chosen, resets the loop counters and begins reissuing 
the SIGP again (step 2). 

13 Determines if the return code must be con¬ 
verted. Converts all non-zero return codes 

for RISGNL and RPSGNL callers to return code 4. 

DSGNL return codes are not converted. The 
following are the return codes: 

X '00'« successful 

X '04* = RI/RP SGNL function not 

initiated 

X '08' = DSGNL function unsuccess¬ 
ful or “SENSE” request is made. 

X 'OC* ■ DSGNL processor not 
operational. 

X '14' = MSSF currently inoperative 

14 Clean up: resets the LCCA spin bit, closes 
the window, and releases the CPU lock. 

15 Records information in the SDWA. 

16 Indicates percolate and returns to RTM; 
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Diagram SUP-34. Suspend Lock Manager Processing (IEAVESLK) (Part 1 of 10) 
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Diagram SUP-34. Suspend Lock Manager Processing (IEAVESLK) (Part 2 of 10) 

Extended Description Module Label Extended Description Module Label 


The lock manager provides the means for a user to obtain | EAVESLK 
locks that serialize the use of a resource. The suspend lock 
manager provides the following locks: 

• Cross memory services 

CMS (the general cross memory services lock) 

CMSEQDQ (the ENQ/DEQ cross memory services 
lock) 

CMSSMF (the SMF cross memory services lock) 

• LOCAL (local address space lock) 

• CML (cross memory local address space lock) 

The lock manager both obtains and releases locks. There 
are two distinct methods of obtaining locks; conditionally 
and unconditionally. If the lock cannot be obtained for a 
conditional request, the lock manager immediately re¬ 
turns control to the caller with the appropriate return 
code in register 13. If an unconditional request for a suspend 
type lock cannot be satisfied, the lock manager places the re¬ 
questor on a lock manager suspend queue until the lock be¬ 
comes available. 


1 The lock manager determines whether the caller has IEAVESLK 
violated the locking hierarchy by: 

a Unconditionally requesting a lock lower in the hier¬ 
archy than a lock it already holds. 

• Requesting a cross memory services lock while not 
holding the local lock. 

• Requesting a suspend lock while disabled. 

The lock manager abnormally terminates callers who vio¬ 
late the hierarchy with a X'073* completion code and a 
reason code in register 15. 

2 The lock manager determines whether this processor 
already owns the requested lock. If this processor 

owns it, the lock manager puts a code of 4 in register 13, 
and returns control to the caller. Otherwise, processing 
continues. 

3 The lock manager tries to obtain the lock. If the lock 
is available (the lockword contains 0), the lock man¬ 
ager indicates ownership by: 

• Placing into the lockword the logical processor ID or, 
for a cross memory services lock, the locally locked 
ASCB address 

a Setting the appropriate bit in the processor-locks-held 
string (PSACLHS) 

• For the CM L lock, placing into the PSALOCAL field 
a pointer to the ASCB of the address space whose 
CML lock is held 


The lock manager then returns to the caller with a zero 
return code. If the lock is not available, processing con¬ 
tinues at step 4. 
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Diagram SUP-34. Suspend Lock Manager Processing (IEAVESLK) (Part 3 of 10) 


Input 
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Output 
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Diagram SUP-34. Suspend Lock Manager Processing (EEAVESLK) (Part 4 of 10) 

Extended Description Module Label 

4 

• For conditional requests. I EAVES LK sets a return code of 
8 and returns control to the caller. 

• For unconditional requests for suspend locks 
(LOCAL. CML. or cross memory services), processing 
continues at step 5. 
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Diagram SUP-34. Suspend Lock Manager Processing (IEAVESLK) (Part 5 of 10) 


Input Process Output 
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Diagram SUP-34. Suspend Lock Manager Processing (1EAVESLK) (Part 6 of 10) 


Extended Description Module Libel 

5 The lock manager suspends the requesting task or SRB. 

• IEAVESLK issues the SETFRR macro to establish 
IEAVLKRR as the functional recovery routine (FRR); 
and turns on the lock manager super bit. 


e I EAVESLK saves the caller's status depending on the 
caller's mode (task or SRB), and which lock the caller 
requested (LOCAL, CML, or cross-memory services). 


Caller's 
Lock ^>^mode 
requested — 

Task mode 

SRB mode 

LOCAL 

• Saves the caller's 
registers end cross 
memory status in 
the TCB and XSB. 

• Stores into the R0 
a PSW that causes 
the requestor to 
reenter 1 EAVESLK 
when redispatched. 
There 1 EAVESLK 
tries again to ob¬ 
tain the local lock. 

Calls the STOP/RESET 
service routine 
(IEAVESRT) at entry 
point IEAVSUSF to 
save the requestor's 
status. IEAVESRT ob¬ 
tains storage for an 

SSRB and XSB and 
saves the requestor's 
status in them. The 
saved SRB causes re¬ 
entry to 1 EAVESLK 
where IEAVESLK tries 
to obtain the LOCAL 
lock. It returns the ad¬ 
dress of the SSRB to 
IEAVESLK. 

CML 

• Obtains an SRB to 
represent the task's 
request on the lock 
suspend queue. 

• Initializes the SRB 
to enter the lock 
manager subroutine 
IEAVRTCB when 
dispatched. 
IEAVRTCB issues 
a RESUME macro 
to resume the sus¬ 
pended task, which 
tries again to ob¬ 
tain the CML lock. 

Same as above 


Extendod Description Module Label 

5 (continued) 


Caller's 

Lock^^niode 

requested 

Task mode 

SRB mode 

Cross- 

memory- 

services 

Calls the STOP/RE¬ 
SET service routine 
(IEAVESRT) at 
entry point 
IEAVSUSF to save 
the requestor's 
status. IEAVESRT 
saves the task's 
status in the IHSA, 
TCB, and XSB. 

Same as above 


Unless I EAVESLK is saving status for a task that requested the 
LOCAL lock, it suspends the lock requestor on the 
appropriate lock's suspend queue. To do so, I EAVESLK places 
either the locally locked ASCB address (for a task requesting a 
cross-memory-services lock), the SRB (for a task requesting 
the CML lock), or the SSRB (for an SRB) on the suspend 
queue. I EAVESLK then gives control to the dispatcher at 
entry point IEAVDSPC. 
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Diagram SUP-34. Suspend Lock Manager Processing (IEAVESLK) (Part 7 of 10) 


Input 


From SET LOCK 
macro to release 
a suspend-type 

lock n Process 


Output 


Release of Suspend-type Lock 

0 Test for a hierachy violation. 

• Hierarchy violation. 


Determine if the processor 
holds the lock. 

• If the lock is held by this pro¬ 
cessor, continue at the next 
step. 

• If the lock is held by another 
processor 

• If the lock is not held 

• If the caller requested that a 
CML or local lock that it does 
not hold be released 
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Diagram SUP-34. Suspend Lock Manager Processing (IEAVESLK) (Part 8 of 10) 

Extended Description Module Label 

g The lock manager tests for a hierarchy violation. 

There are two violations that can occur during a 
release. 

• The caller tries to release a local lock while holding 
a cross memory services lock, 
o The caller tries to release one of the cross memory 
services locks while holding all of them. 

If one of these occurs, IEAVESLK abnormally terminates 
the caller with an X'073' completion code. 

7 If this processor does not hold the lock, IEAVESLK 
returns to the caller with a return code in register 
13. If no processor holds the lock, the return code is 
4. If another processor owns the lock, the return 
code is 8. If the caller requested that a CML or local 
lock that the caller does not hold be released, the 
return code is 1Z 

If this processor owns the lock, the lock manager re¬ 
leases it by setting the lockword to zeros. 
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Diagram SUP-34. Suspend Lock Manager Processing (IEAVESLK) (Part 9 of 10) 


Input 
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Diagram SUP-34. Suspend Lock Manager Processing (IEAVESLK) (Part 10 of 10) 

Extended Doeription Module Label 

8 When releasing a local lock on which no CML re¬ 
questor is suspended, IEAVESLK: 

e Dequeues the first suspended SRB on the lock's sus¬ 
pend queue. 

e Stores the ready-to-run ID in the lockword 
(ASCBLOCK). 

e Sets the SRBHLHI field to indicate that the unit of 
work holds the LOCAL lock. 

• Sets the local lock field (PSALOCAL) to zero. 

• Schedules the SRB. 

If a CML requestor b suspended on the local lock, 

IEAVESLK: 

• Sets the lockword (ASCBLOCK) to zero. 

e Sets the local-lock-held flag (PSACCLHS) to zero. 

• Sets the local lock field (PSALOCAL) to zero. 

• Dequeues and reschedules every SRB on the lock's 
suspend queue. 

For cross memory services locks, [ IEAVESLK dequeues all 
of the ASCBs and SSRBs on the lock's suspend queue. * 

For each SRB released, IEAVESLK reschedules the SRB 
locally. 

For each ASCB dequeued, IEAVESLK calls the STOP/RESET 
routine (IEAVESRT) to mark the task dispatchable. (See 
the IEAVESRT diapam for details). 

9 IEAVESLK updates the PSACLHS field to show that 
the processor no longer holds the released locks, and 

returns to the caller with a 0 in register 13. 

Recovery Processing: 

Lock recovery processing is described in the diagram 
"Suspend Lock Manager Repair Router (IEAVESLR)". 

The FRp routine for suspend lock manager, IEAVLKRR, 
is an entry point within IEAVESLR. 
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Diagram SUP-35. Suspend Lock Repair Routine (IEAVESLR) (Part 1 of 2) 


Input 


Register 0 


Entry Code 


Register 1 


PAR MUST 


PARMLIST 


Pseudo SDWA 


RTM error data 

or 0 


PSACLHS 


Bit string 
indicating locks 
held 

SLA 


CMSSMFLK 

CMSPRSQH 

ippBiiiiiM 

'CMSF' 

CMSEDLK 

ppyiiiBFFlM 


'CEDQ' 

CMSLOCK 
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| 'CMS 1 | 

H H 

ASCB 


ASCBLOCK 

ASCLCMLC 

ASCBLOCI 


PSA 


PSA LOCAL 

PSAAOLD 



| Process 

m 


Output 


^>1 Ensure that the current locks 
held string agrees with the 
contents of the suspend 
lockwords. 


Pseudo SDWs 




$ 


PSACLHS 


Bit string 
indicating locks 
held 

SLA 


CMSSMFLK 

CMSPRSQH 


'CMSF' 

CMSEDLK 



'CEDQ' 
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Diagram SUP-35. Suspend Lock Repair Routine (IEAVESLR) (Part 2 of 2) 

Extended Description Module Label 


The suspend lock repair routine correlates the current locks 
held string to the suspend lockwords with the assumption 
that a double error has not occurred (i .e., the lockword and the 
current locks held string are not both invalid), and assures 
that a valid current locks held string, when matched against 
the lockwords, does exist. If an invalid state is detected, the 
suspend lock repair routine either alters the current locks 
held string or corrects the lockword, depending on the de¬ 
tected state. In extreme cases, the routine steals a lock or 
locks in order to allow the system to continue. If either a 
DAT error occurs while a CMS lock owner is suspended, or a 
restart interrupt occurs while a CMS lock owner is suspended 
and the system is in a wait situation (unless the lock owner is 
suspended on a CMS suspend queue as a result of an uncon¬ 
ditional obtain request for all CMS locks), the routine steals 
all CMS locks owned by the lock owner. In certain cases, a 
lock will not be corrected even though an invalid value may 
be in the lock. In this case, rather than stealing a resource 
away from a possible owner, the lock is made unavailable 
for use until all CPUs involved are waiting on the lockword. 
At this time, depressing the restart key is an appropriate 
action which enables this routine to clear the unavailable ' 
lock. 

The suspend lock repair routine logs repair in the VRA 
portion of the pseudo SDWA. If an invalid state is 
detected and the lockword is modified, the pseudo SDWA 
<*rea is provided by the caller. 
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Diagram SUP-36. Suspend Lock Manager FRR Routine (IEAVESLR) (Part l of 4) 
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Diagram SUP-36. Suspend Lock Manager FRR Routine (IEAVESLR) (Part 2 of 4) 

Extended Description Module Label 

IEAVESLR contains the suspend lock manager FRR 
routine and the suspend lock repair routine. 

The suspend lock manager (IEAVESLK) places the suspend 
lock manager FRR (IEAVLKRR) on the FRR stack. 

1 IEAVLKRR establishes module addressability and 
establishes addressability to SDWA and VRA. 

2 IEAVLKRR logs information in the SDWA and VRA. IEAVESLR LOCKFRR 
It uses lock recovery routine recording area (RRRA) 

to communicate to the FRR routine the type of processing 
being performed. The RRRA is logged in the VRA for 
debugging information. IEAVESLK indicates (via the 
SETRP macro) to record the logged information. 
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Diagram SUP-36. Suspend Lock Manager FRR Routine (IEAVESLR) (Part 3 of 4) 
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Diagram SUP-36. Suspend Lock Manager FRR Routine (IEAVESLR) (Part 4 of 4)' 


Extended Description Module 

3 IEAVESLK was releasing LOCAL or CML lock at the 
time of the error, IEAVKLRR reschedules all of the 

suspended SRBs on the local journal queue or the ASCB 
lock suspend queue. 

If I EAVESLK was releasing a CML lock at the time of the 
error, IEAVKLRR resets each ASCB and reschedules each 
SRB suspended on the CMS lock suspend queue or the CMS 
journal queue. 

4 IEAVKLRR determines if the system is in a known 
state (SRB mode, task mode, or supervisor system 

mode) by checking the LCCASRBM bit, the PSATOLD 
field, and the PSASUPER bits. If the system is in a known 
state, IEAVKLRR issues a SETRP macro to request perco¬ 
lation to the next FRR. If the system is in an unknown 
state, IEAVKLRR issues a SETRP requesting retry at entry 
point IEAODS in the dispatcher. 


Label 
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Diagram SUP-37. Super FRR (IEAVESPR) (Part 1 of 4) 


From RTM to 
recover a supervisor 
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Diagram SUP-37. Super FRR (IEAVESPR) (Part 2 of 4) 

Extended Description Module 

The super FRR determines the routines processing when an 
error occurred, routes control to that routine's recovery 
routine Of one exists) and performs actions based on return 
information. 

*| The super FRR checks for a recursive entry. Control IEAVESPR 
goes to step 7 for recursive entries; otherwise, process¬ 
ing continues. If a DAT error occurred, super FRR requests 
an address space termination (see step 4). 

2 The system trace recovery routine is called to allow 
clean up and recovery of system trace fields. 

2 The super FRR uses SETRP to indicate a retry address 
to one of the FLIH recovery routines. After super 
FRR returns to RTM, RTM routes control to the specified 
retry address. The recovery routines that protect the dis¬ 
patcher and the interruption handler are: 

• Dispatcher- IEAVEDSR 

• RTM - IEAVTRTF 

• SVC IH - IEAVESVR 

• I/O IH - IEAVEIOR 

• External IH - IEAVEE1R, IEAVEE2R, and IEAVEE3R 

• Machine check IH - IGFPMSUP 

• Program check IH — IEAVEPCR 

• Restart IH - IEAVERER 

4 The super FRR, after receiving control back from the 
recovery routine, will terminate the address space or 

the task, as requested by the dispatcher FRR or as in 
step 7. The MEMTERM or ABTERM completion code is 
X '07C* and the reason code is zero. 

5 The super FRR records error information in the 
SDWA (system diagnostic work area). 


Label 
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Diagram SUP-37. Super FRR (IEAVESPR) (Part 3 of 4) 
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Diagram SUP-37. Super FRR (IEAVESPR) (Part 4 of 4) 

Extended Description Module 

6 The super FRR purges the translation lookaside 
buffers via a PTLB (purge translation lookaside buffers) 
instruction. Control returns to RTM when the PTLB opera¬ 
tion completes. RTM will retry to the appropriate FLIH or 
dispatcher retry routine whose address was put into the SDWA 
retry field, SDWARTYA. 

7 For one recursion, the super FRR terminates the home 

address space in which the error occurred. If a second IGFPTERM 
recursion occurs during super FRR processing, the system 
will be terminated. System termination prints an IEA967W 
message at the console: 'Unsuccessful recovery attempt by 
supervisor control*. The super FRR issues a system wait 
state code of X*01C\ 


Label 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) (Part 1 of 22 ) 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) 

Extended Description Module 

IEAVESRT performs one of two functions. It either saves 
status and suspends a task or SRB, or restores status and 
makes a suspended task or SRB redispatchable. Suspend 
processing is described in steps 1-25. Reset processing is 
described in steps 26-28. 

IEAVESRT has two entry points: 

IEAVSUSC — Used to suspend a task or SRB 
IEAVRSTC — Used to reset a task or SRB 

Input to IEAVESRT is shown in the input section of the 
diagram opposite each entry point. 

IEAVESRT contains two recovery routines: 

STOPFRR — The FRR entry point for recovery 
for Suspend processing 

RESETFRR — The FRR entry point for recovery 
for Reset processing 

1 IEAVESRT saves the caller's registers in the save IEAVESRT 

area pointed to by register 13. 

2 IEAVESRT establishes STOPFRR as the recovery 
routine for suspend processing. For more 

information, see "Recovery for Suspend Processing" 
at the end of this extended description. 

3 Unless the processor timer is damaged, IEAVESRT 
records the processor time in the PSA, unless 

the caller has already done so. 

4 If the caller has specified a number of FRR entries 
not to be copied to the normal stack, and the 

current stack is not the normal stack, then the caller 
is abnormally terminated with a completion code of 
X'059' and a reason code of X'18\ 

5 If the PSW at the time of the suspend request is not 
enabled for external and I/O interrupts, IEAVESRT 

issues ABEND X'059' with reason code 0. 


(Part 2 of 22) 
Label 


IEAVSUSC 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) (Part 4 of 22) 
Extended Description Module Label 

g If the processor is in task vnode and the task being 
suspended holds the LOCAL or CML lock, process¬ 
ing continues at step 9. If the processor is in task mode 
but neither of these locks is held, processing continues at 
the next step. If the processor is in SRB mode, process¬ 
ing continues at step 18. 

Suspending an Unlocked Task 

7 IEAVESRT issues a CMSET SET macro to make IEAVESRT UNLKTCB 

the home address space of the TCB being suspended 
the primary address space. 

If the current RB has a non-zero wait count (RBWCF), 

IEAVESRT abends the caller with a completion code of 
X'059 # reason code X'OC'. This indicates a request to stop 
an unlocked task that is already stopped. 

8 IEAVESRT saves the current status in the TCB 
being suspended and in its associated XSB and RB. 

The status saved includes: 

• Cross memory control registers. 3 and 4. 

• General purpose registers. 

• The PSW at the time of the suspend request. 

• The translation exception address (TEA). When the sus¬ 
pend request is not the result of a page fault, the TEA 
(the LCCAPVAD field) is zero. 

To suspend the task, IEAVESRT set the wait count 
in the current RB (RBWCF) to one and subtracts 
one from the count of ready TCBs in the home address 
space (ASCBTCBS). 

If the count of TCBs requiring the local lock (ASCBTCBL) 
is zero. IEAVESRT takes a time stamp in ASCBEWST, and 
increases the current short wait count (ASCBSWCT) by one. 


Extended Description Module Label 

10 IE A V ESRT restores the catier's cross memory 
state, deletes the FRR, loads the 3 words of the 

output area with values shown on the output section 

of the diagram (the value of the TCB, the value of RB 

and zero, respectively), and return to caller. 

Suspending a Locked Task 

11 IEAVESRT issues a CMSET SET macro to make the 
home address space the primary address space. 

IEAVESRT calls the job step timing module (IEAVEJST) 

to calculate elapsed job step time. 

12 IEAVESRT issues a CMSET SET macro to make IEAVESRT LOCKTCB 

the address space whose local lock is held the primary 

address space. 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 



CO 

cz 

"O 

I 

IN) 


3 

< 

CO 

X 

X 

2» 

CO 


CO 

c 

•o 

A 


Diagram SUP-38. STOP/RESET Service Routine (DEAVESRT) i 


Input Proce 



STCBVAFN 


5 of 22) 






















LY28-1765-0 (c) Copyright IBM Corp. 1987 Method of Operation SUP-271 


Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) 

Extended Description Module 

13 If the task has an active vector environment, 

IEAVESRT will: 

• Store the vector activity count in the VSSAVAC. 

• Save the vector registers in the task's VSSA. 

• Place a X'20' value in STCBVAFN to indicate the 
vector registers are in the VSSA. 

• Set bit 14 in control register 0 to zero to prevent 
execution of vector instructions. 


(Part 6 of 22) 
Label 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) 

Extended Description Module 

*|4 IEAVESRT saves the following status information in IEAVESRT 
the locked address space's IHSA and the XSB chained 
from it. 

• Cross memory control registers 3 and 4 in the XSB 

• The PCLINK stack header in the XSB 

• The address of the locked ASCB in the IHSA's XSB 
and TCB 

• Current floating point registers 0, 2, 4, and 6 in the IHSA 

• General purpose registers and the PSW at the time of the 
suspend request in the IHSA 

• The processor timer value in the IHSA 

• The entire normal FRR stack in the IHSA, or if the caller 
has specified a number of FRR entries not to be copied, 
saves the normal FRR stack minus the specified number 
of FRR entries. 

• The value of the enabled, unlocked task FRR flag in the 
IHSA 

• The current and old TCB addresses in the IHSA 

• The LOCAL- or CML-lock-held indicator in the ASCB, 
and the local-lock-held indicator in the TCB 

• The TCB address in the ASCB 

IEAVESRT also stores a pointer to the TCB, a pointer 
to the RB, and a pointer to the locked ASCB into the 
output area. These values are returned to the caller at 
exit. 

*15 If the primary address space is not the home address 
space, IEAVESRT issues the CMSET SET macro 
to make the home address the primary address space. 


(Part 8 of 22) 

Label 

LOCKTCB 
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Diagram SUP-38. STOP/RESET Service Routine (DEAVESRT) (Part 9 of 22) 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) (Part 10 of 22) 
Extended Description Module Label 

16 To suspend the task, IEAVESRT: IEAVESRT LOCKASCB 

o Puts the suspend ID into the ASCB lockword 
o Subtracts one from the count of ready TCBs In the 
suspended task's home ASCB 
e Subtracts one from the count of active processor's 
in task mode 

If the count of TCB's requiring the local 
lock (ASCBTCBL) is zero, IEAVESRT takes a time 
stamp (via the STCK instruction) in ASCBEWST, 
and increases the current short wait count (ASCBWCT) 
by one. 

17 To reset the processor's state, IEAVESRT sets to 
zero the fields shown in the output section of the 

diagram. 

lg IEAVESRT restores the caller's cross memory status, IEAVESRT USERMODE 
delates the FRR, and returns to the caller. 

Suspending an 8RB 

ig i IEAVESRT Issues a GETSSRB macro to obtain storage IEAVESRT SRBSPND 
for an SSRB and XSB In which to save status. 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) (Part 11 of 22) 
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Diagram SUP-38. STOP/RESET Service Routine (1EAVESRT) (Part 12 of 22) 


Extended Description Module 

20 Call job step timing module (IEAVEJST) to 
calculate elapsed job step timing. 

21 IEAVESRT saves the following status information: 

• Cross memory control registers 3 and 4 in the XSB 

• The PSW at the time of the suspend request in the XSB 

• The PCLINK stack header in the XSB 

• The address of the ASCB holding the local lock In the 
XSB 

• The current floating point registers in the SSRB 

• General purpose registers and the PSW at the time of 
the suspend request in the SSRB 

• The adjusted processor timer and SRB time values in 
the SSRB 

• The entire normal FRR stack in the SSRB. or, if the 
caller has specified e number of FRR entries not to 
be copied (entry point IEAVSUSF), saves the normal 
stack minus the specified number of FRR entries. 

• The CPU affinity information in the SRB 

• The address of the home ASCB in the SRB 

• The translation exception address in the SSRB 

• The LOCAL- and CMS-lock-held indicators in the SRB 
and ASCB 


Label 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) (Part 13 of 22) 


Process 


22 Suspend tho SRB. 


23 R«*et the processor^ 
state. 



24 Clean up and return. 


Output 


3 



ASCB _ 

ASCBSCNT (no. of suspended SRBs) 
ASCB LOCK (lockword) 


PSA _ 

PSASTKE 
PSACLHS 
PSA LOCAL 


LCCA 



LCCASRBM 

SRB mode 

LCCAGSRB . 

indicators 




OUTPUT AREA 
f SSRB 

0 


Return 
to caller 


locked ASCB 
(0 If not locked) 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) (Part 16 of 22) 


Extended Description Module 

25 IEAVESRT resets SSRBs, locked tasks, and unlocked IEAVESRT 
tasks in different ways. Step 26 describes how an 
unlocked task is reset, step 27 a locked task, and step 28 
an SSRB. The Input parameter list points to the output 
area filled in by IEAVESRT when this unit of work was 
stopped. 

If the reset type code (in the input parameter list) is not 
a zero (unconditional), or a four (conditional), or is an 
eight (page I/O error reset request), then the following 
reset error processing takes place: 

• IEAVESRT establishes IEAVSCHF as the recovery 
routine for error processing designed to terminate 
the suspended SRB or TCB. 

• if the caller is in secondary address mode, or if 
the reset ASCB (in the output area) is not the 
home ASCB, IEAVESRT establishes primary 
addressability to the reset address space. 

IEAVESRT obtains and Initializes an SSRB to 
represent an SRB reset request. IEAVESRT 
schedules the SRB, deletes recovery and 
returns to the caller. (The SRB entry 

point is IEAVSRBR in module IEAVESRT.) 

Otherwise, if the local lock is held or If it 
cannot be obtained, IEAVESRT issues 
a CALLRTM TYPE=STERM to 
terminate the suspended SRB or TCB. 

If the local lock was obtained, IEAVESRT 
releases it, deletes recovery, and returns 
control to the caller. 

The STERM completion code is the reset 
type code (in the parameter list) except for 
the page I/O error case for which the 
completion code is set to X'08\ 


Label 

RSETCOMM 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) (Part 17 of 22) 


Input 


Input parameter list 
I | output area 


Reset type code 


Process 


TCBXLAS 


TCBLLH 


TCBFLGS4 


OUTPUT AREA 


^ TCB 


| RB 


j ASCB 


>4 _ 


mask 


registers 


PSW 

TCB 



26 Reset an unlocked task 
by issuing a RESUME 
macro. 


27 Reset a locked task by: 

1) Adding the locked ASCB 
to the true ready queue. 

2) Notifying the dispatcher 
that work is ready. 


IEAVEMS5 


Memory 

twitch 


Return 
to caller 


. Output 


Register 15 


0, if task it resumed 

4, If task cannot be returned 


1 EAVEMSA 


TCB Register 7 

TCBXLAS (f ASCB f 

. holding CML lock) OR holding 
f _ local lock 


TCBCMLR (ready- 
to-run flag) 


ASCB 1 


ASCBLOCK (lockword) 


ASCBTCBS 


ASCB 


ASCBLOCK 

ASCBTCBS 


ihsagprs 


IHSACPSW 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) (Part 18 of 22) 

Extended Description Module Libel 

26 To reset an unlocked task, IEAVESRT: IEAVESRT NOLKTCB 

e Establishes addressability to the input ASCB (the task's 
home address space! 

• Depending on the Input code in register 6 , Issues either 

a conditional or an unconditional asynchronous RESUME 
macro 

o Iff the conditional RESUME macro falls, sets a return code 
off 4; otherwise, sets a return code off zero 

• Returns to the caller 

27 I! the task is not locked (TCBLLH is zero) but the IEAVESRT RSETCB 

caller's input Indicated locked, IEAVESRT abends 

the caller with a completion code of X'059* and a reason 
code of X'10\ Otherwise, to reset a task that holds the 
CML or LOCAL lock, IEAVESRT: 

• Establishes addressability to the input ASCB 

• Establishes RESETFRR as the recovery routine 
for reset processing 

• If the lock held by the task does not contain the suspend 
ID, abends the C8ller with a completion code of X'059* 
and a reason code of X'14* 

• If the caller requests, update the resume registers and/or 
PSW with the values supplied by the caller. 

• Iff the TCB is dispatchable, IEAVESRT increases the 
count of ready-to-run TCBs (ASCBTCBS) by one 

• If the task holds the LOCAL lock, replaces the suspend 
ID in the ASCB lockword with an interrupt ID 

• * If the task holds the CML lock, replaces the suspend IEAVESRT RSETQML 
ID in the CML~locked ASCB with a ready-to-run ID, 

and sets the ready-to-run flag in the TCB, calls Memory 
Switch to add the locked ASCB to the true ready queue. 

• Calls the memory switch module (IEAVEMS5) to IEAVESRT RSETMEMS 

notify the dispatcher that work is ready 

• Deletes the FRR 

• Returns to the caller 
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Diagram SUP-38. STOP/RESET Service Routine (1EAVESRT) (Part 20 of 22) 


Extended Description Module Label 

28 To reset an SSRB: IEAVESRT RSETSRB 


• If requested, update the resume registers and'PSW 
(in SSRBGPRS and SSRBCPSW). 

• If the SSRB holds a CML or LOCAL lock, IEAVESRT 
replaces the suspend ID in the locked ASCB's 
lockword with a ready-to-run ID and adds the locked 
ASCB to the true ready queue. 

• IEAVESRT schedules the SSRB. 

Recovery for Suspend Processing 
When an error occurs while IEAVESRT is suspending a 
task or SRB. RTM gives control to STOPFRR, and entry 
point within IEAVESRT. STOPFRR records the error 
in the SDWA and records the FRR parameter area, the 
caller's ASID, the PSATOLD value, the caller's return 
address and the stop input parameter list in the SDWA's 
variable recording area. If a recursive or DAT error has 
occurred, or if the STOPFRR was entered as a global 
resource manager (SDWAGLBL is 1), STOPFRR 
requests percolation 8nd returns to RTM. If IEAVESRT 
has finished processing the request (both the PSATOLD 
field and the LCCASRBM bits are zero), STOPFRR 
requests that RTM retry at label SFRRETRY. There 
IEAVESRT restores the caller's registers and returns to 
the caller. In all other cases, STOPFRR's actions 
depend on whether IEAVESRT was suspending an 
unlocked task, a locked task, or an SRB, and where 
processing the error occurred. 

If the PSATOLD field Is nonzero, the local lock flag In 
the PSACLHS field is zero, and the TCBLLH flag has 
not yet been set, IEAVESRT was suspending an 
unlocked task. STOPFRR determines'whether 
IEAVESRT altered the TCB's status. 

• If the status has not been altered (the RB wait count 

Is zero), STOPFRR requests a retry at label SFRRETAB. 
There IEAVESRT restores the caller's registers end 
terminates the caller with X '059* abend and 
reason code X *08*. 

• If TCB status has been changed, STOPFRR resets the 
RB wait count to zero and adds one to the count of 
ready TCBs (ASCBTCBS) before requesting a retry 
at SFRRETAB. 


IEAVESRT STOPFRR 


If IEAVESRT was suspending a locked task when the 
error occurred, STOPFRR determines whether IEAVE8RT 
eltered the processor's lock status. 


Extended Description Module Label 

e If the lock status has not been changed (both the IEAVESRT SRRTCBCM 

current TCB's locaMock-held flag, TCBLLH, and the 
locked ASCB's highest-lock-held field, ASCBHLHI, 
are zero), STOPFRR requests a retry at label SFRRETAB. 

a If the processor's lock state has changed, STOPFRR: 

— Puts the processor ID In the local lockword (only 
If TCBLLH-1) 

— Restores the PSANSS flag from the locked IHSA 

— Restores the PSASTKE and PSA LOCAL from the 
value saved in the locked IHSA's XSB 

— Makes the PSACLHS field match the locked ASCB's 
ASCBHLHI field, and clears the ASCBHLHI field. 

— Adds one to the count of ready TCBs (ASCBTCBS) 

— Requests a retry at label SFRRETAB 

If IEAVESRT was suspending an SRB (LCCASRBM-1), IEAVESRT SRRSRBM 

recovery processing depends on whether IEAVESRT had 
changed the processor status and/or the SRB's local-lock- 
held field (SRBLLHLD). 

• If the processor status has not been changed (no SSRB 
has been obtained), STOPFRR requests a retry at label 
SFRRETAB to abend the caller. 

• If the processor status has been changed, but the 

SRBLLHLD flag has not yet been set, STOPFRR: IEAVESRT SRRSRBLH 

— Restores the PSASTKE from the value saved In the 
XSBSTKE field 

— Returns the SSRB/XSB to the SRB/SSRB pool 

— Requests a retry at label SFRRETAB 

• If the SRBLLHLD flag has been set. STOPFRR: 

— Puts the processor's ID Into the lockword of the 
appropriate locked ASCB 

— Sets in the PSACLHS field the bits that are set in the 
SRBHLHI field 

— Restores the PSASTKE from the value saved In the 
XSBSTKE field 

— Restores PSALOCAL from the XSB (XSBXLAS) 

— Resets to zero the locked ASCBCMLH field of 
the ASCB 

— Returns the SSRB/XSB to the SSRB/XSB pool 

— Requests a retry at label SFRRETAB 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) (Part 21 of 22) 


Input 


Process 


Output 



Entry Point: IEAVSRBR 
(Reset SRB routine) 

29 If the reset request is not for 
a locked task or an SRB, ob¬ 
tain home's local lock. 


30 Obtain the CPU lock. 

31 Release all locks and free 
the SSRB storage. 


32 Delete the SRB recovery 
routine (FRR). 

33 Return to the caller. 
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Diagram SUP-38. STOP/RESET Service Routine (IEAVESRT) (Part 22 of 22) 
Extended Description Module Label 

29 (Continued) 

Recovery for Reset Processing 

When an error occurs while IEAVESRT is resetting a IEAVESRT RESETFRR 

locked task, RTM gives control to RESETFRR, an 

entry point within IEAVESRT. RESETFRR records 

the error in the SDWA and records the FRR parameter 

area, the caller's ASID, the PSATOLD value, the caller's 

return address, the reset input parameter list, and 

the stop output area in the SDWA's variable 

recording area. If a recursive or DAT error has 

occurred, RESETFRR percolates the error. 

Otherwise, RESETFRR attempts to finish re¬ 
setting the locked task as described in step 26. 

It then requests a retry at label RFRRETRY, where 
IEAVESRT restores the caller's cross memory status 
and registers, and returns to the caller. 

Recovery for Reset Error Processing 

When an error occurs while IEAVESRT is processing an 

invalid RESET request, RTM gives control to IEAVSCHF, IEAVESRT IEAVSCHF 
an entry point within IEAVESRT. IEAVSCHF records 
the error in the SDWA and records the FRR parameter 
area, the caller's ASID, the current task pointer 
(PSATOLD), and all the input parameters in the SDWA's 
variable recording area (VRA). If an SSRB pointer Is 
available in the FRR parameter area (indicating that a 
reset schedule was in progress) then IEAVSCHF records 
the entire SRB in the VRA and frees the SSRB. If the 
-CPU lock was obtained by the SRB routine, IEAVSCHF 
records this information in the VRA and frees the CPU 
lock. If the local lock was obtained by the SRB routine, 

IEAVSCHF records this information in the VRA and 
frees the local lock. 

The recovery routine then percolates to the next level of 
recovery. 


Extended Description Module Label 

30 Check the output area filled in by STOP. IEAVESRT 1EAVSRBR 

If the RB address is zero (indicating that an SRB 

is requested) or bit 0 of the TCB address is one 
(Indicating a locked TCB), then do not obtain home's 
local lock. 

31 Obtains the CPU lock to disable external and I/O 
interrupts. 

32 Releases the CPU lock and then the local lock. 

Converts the SRB ID field to an SSRB ID and 

releases the SSRB storage. 

33 Deletes the FRR from the FRR stack. 
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IEAVESTU - MODULE DESCRIPTION 


DESCRIPTIVE NAME: DYNAMIC SVC TABLE UPDATE SERVICE 
FUNCTION: 

The SVC Dynamic Update Service updates entries in the System 
SVC Table for "REPLACE/DELETE" requests. The old SVC Table 
Entry and other data about the update request is stored in the 
SVC Update Recording Table. It returns information from the 
SVC Table for '•EXTRACT" requests. 

ENTRY POINT: IEAVESTU 

PURPOSE: Main entry point of the module. See Operation Section. 
LINKAGE: 

"SVCUPDTE" generates "BASSM" with register 1 
pointing to the parameter list 

CALLERS: 

(via SVCUPDTE macro interface) 

IEAVNP25, 

IEAVNPS5, 

IEAVNPST 

Any supervisor state/key zero routine 
INPUT: 

- An SVCUPDTE Parameter list 

with the address passed in Register 1. 

OUTPUT: 

REPLACE/DELETE requests: 

- SVC Table is updated. 

- SVC Update Recording Table is updated. 

EXTRACT requests: 

- SVC Number is loaded into Register Zero. 

EXIT NORMAL: Return to caller 

EXIT ERROR: Return to caller 

ENTRY POINT: IEAVESTE 

PURPOSE: 

Secondary entry point to extract the entry-point address 
of an LPA-resid8nt routine 

LINKAGE: BASSM with register 1 pointing to a parameter list 

CALLERS: 

IEAVNPS5 

IEAVNPST 

INPUT: - A Parameter area with the address passed in Register 1. 
OUTPUT: 

- Register 0 is loaded with the entry point address of 
the LPA routine. 

EXIT NORMAL: Return to caller 

EXIT ERROR: Return to caller 

ENTRY POINT: IEAVESTR 

PURPOSE: 

IEAVESTR is a Functional Recovery Routine (FRR) which 
provides recovery from errors incurred while: 

1. Attempting to update the SVC Table and the 
SVC Update Recording Table. 
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SUP-39. Dynamic SVC Table Entry Installer (IEAVESTU) 
IEAVESTU - MODULE DESCRIPTION (Continued) 


or 

2. Attempting to GETMAIN storage for a register 
savearea. 

LINKAGE: From Recovery Termination Manager (RTM) 
CALLERS: None 

INPUT: - See introductory comments to the FRR. 

OUTPUT: - SDWA as modified by SETRP macro. 

EXIT NORMAL: Return to RTM. 

EXTERNAL REFERENCES: 

ROUTINES: 

IEAVENLU - Nucleus Lookup Routine 
IEAWMSR - LPA Directory Search Routine 


CONTROL BLOCKS: 

CDE (Contents Directory Entry) - Cr) 

CVT (Communication Vector Table) - (r) 

FRRS (FRR Routine Stack) - (r>w) 

LPDE (Link Pack Directory Entry) - (r) 

PSA (Prefix Save Area) - (r) 

SCVT (Secondary CVT) - (r) 

SDWA (System Diagnostic Work Area) - (r»w) 

SVC (SVC Table entry mapping macro) - (r>w) 

tables: 

SVC Table (IEAVSVCT) - (r,w) 

SVC Update Recording Table (IEAVSVCR) - (w) 


SERIALIZATION: 

CDS Serializes updates to SVC Table 

The CPU Lock is held while updating the SVC Table 

and the SVC Update Recording Table. 
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SUP-39. Dynamic SVC Table Entry Installer CIEAVESTU) 

IEAVESTU - MODULE OPERATION 


Upon entry* the routine validity checks the caller's 
parameter list. If the parameter list is invalid the module 
returns with a return code to indicate that the service 
request has failed. 

If the function specified is "DELETE" or "REPLACE'S data in 
the parameter list is converted into an SVC Table Entry. 

If the function specified is "DELETE" then the entry point 
and attributes will be set for IGCERROR. 

If the function specified is "REPLACE" with "EPNAME" 
determine the entry point address as follows: 

For Type 1* 2* or 6 (nucleus-resident) routines> IEAVESTU 
calls the Nucleus Lookup Routine (IEAVENLU) to obtain the 
entry point address. To invoke IEAVENLU* the CPU lock 
will be obtained* IEAVESTR will be established as an FRR 
and IEAVESTU will branch enter GETMAIN to obtain storage 
for a register savearea. The address of the caller's 
savearea* IEAVESTU's savearea and other update 
information* including the current contents of the SVC 
Table Entry will be saved in the FRR parameter area. 

When control is returned from IEAVENLU* the register 
savearea is freed* the FRR is deleted and the CPU lock 
is released. 


For Type 3 and 4 SVCs* IEAVESTU searchs active LPA 
CDEs and* if necessary* calls the Contents Supervisor LPA 
Directory Search Routine CSVSRCH (entry point* IEAWMSR)* 
to obtain the entry point address. 

If the EPA cannot be obtained* IEAVESTU will return to the 
caller with a return code to indicate that the service 
request has failed. 

Once the entry point address for a valid "REPLACE" 
request is obtained processing proceeds as follows: 

Build a new SVC Table entry in registers. 

Set the assist bit if the SVC: 

is not an ESR* and 

is not APF Authorized* and 

is not Non-Preemptive. 

And if the SVC: 

is a TYPE 2, 3* or 4, or 

any TYPE SVC requiring no more than the Local Lock. 
Obtain the CPU Lock. 

Establish IEAVESTR as a recovery routine. 

Save the address of the caller's savearea and other update 
information* including the current contents of the SVC 
Table entry* in the FRR parameter area. 

Invoke the DATOFF Compare Double & Swap Routine (IEAVCDS) 
via DATOFF index* INDCDS to update the SVC Table entry. 
Update the corresponding entry in the SVC Update Recording 
Table. 

Delete the FRR. 
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IEAVESTU - MODULE OPERATION (Continued) 


Release the CPU Lock. 

If the function specified is "EXTRACT'S processing proceeds as 

follows: 

If the "EPNAMF" was specified IEAVESTU obtains the 
entry point address by calling the Nucleus Lookup Routine 
CIEAVENLU). To invoke IEAVENLU, the CPU lock will be 
obtained> IEAVESTR will be established as an FRR and 
IEAVESTU will branch enter GETMAIN to obtain storage for 
for a register savearea. The address of the caller's 
savearea* IEAVESTU's savearea and other update 
information* including the current contents of the SVC 
Table Entry will be saved in the FRR parameter area. If 
the routine is not found in the Nucleus* IEAVESTU searches 
active LPA CDESs. When control is returned from IEAVENLU* 
the register savearea is freed* the FRR is deleted and the 
CPU lock is released. If it is not found on the queue of 
COEs* IEAVESTU calls the Contents Supervisor LPA Directory 
Search Routine* (IEAWMSR). When the entry point address 
is obtained from one of these searches* IEAVESTU scans the 
SVC Table for an entry with a matching entry point 
address. If it is found the SVC number will be returned in 
register zero. If the "EXTRACT" fails* IEAVESTU will 
return with a non-zero return code. 


When this module is called at entry point* IEAVESTE* the logic 
to search the LPA is executed as a separate service for SVC 
Table Initialization routines. 

RECOVERY OPERATION: 

The recovery environment is established whenever IEAVESTU 
obtains the CPU lock. This lock is obtained under two 
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SUP-39. Dynamic SVC Table Entry Installer (IEAVESTU) 

ZEAVESTU - DIAGNOSTIC AIDS 


ENTRY POINT NAMES: IEAVESTU 
IEAVESTE 
IEAVESTR 


MESSAGES: None 
ABEND CODES: None 
WAIT STATE CODES: None 


RETURN CODES: 


ENTRY POINT IEAVESTU: 


EXIT NORMAL: 

A 



U 

EXIT ERROR: 

Decimal 

Hexadecimal 

Reason 

Code 

Code 


04 

04 

Parameter List Version Level 
is invalid. 

SVC Number is not supplied 
for DELETE or REPLACE. 

Version Level 1 on parameter list 
for EXTRACT. 

08 

08 

Extra parameters or RESERVED bits 
not zero for DELETE request 

12 

OC 

SVC Type not equal to 1>2>3»4>5> or 6 
for REPLACE request. 

Extra bits set on in ATTRIBUTE field 
or RESERVED byte not zero for REPLACE 
request. 

Extra bits set on in LOCK field 
for REPLACE request. 

SVC ENTRY POINT not halfword aligned 
for REPLACE request. 

16 

10 

ENTRY POINT passed for a TYPE 5 REPLACE 


request. 

LOCK requested for a TYPE 6 REPLACE 
request. 

Global LOCK requested for a TYPE 3/4 
REPLACE request. 

Neither ENTRY POINT nor EPNAME passed 
for a REPLACE request that is 
not TYPE 5. 

Both ENTRY POINT and EPNAME are passed 
for a REPLACE request. 

ENTRY POINT passed is zero for a REPLACE 
request. 

CMS LOCK requested without LOCAL LOCK 
for a REPLACE request. 


20 

14 

Function is not recognized. 

24 

18 

Attempt to Update ESR Entry. 

28 

1C 

Unable to locate Entry Point Address 
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SUP-39. Dynamic SVC Table Entry Installer (IEAVESTU) 

IEAVESTU - DIAGNOSTIC AIDS (Continued) 


32 


20 


36 24 

40 28 

ENTRY POINT IEAVESTEs 
EXIT NORMALS 
0 = Successful 


for an EPNAME specification. 

Neither ENTRY POINT nor EPNAME passed 
for EXTRACT request. 

Doth ENTRY POINT and EPNAME passed 
for EXTRACT request. 

ENTRY POINT passed is not on 

halfword boundary for EXTRACT request. 

ENTRY POINT passed is zero 
for EXTRACT request. 

SVC number passed for EXTRACT request 

Extra parameters supplied or RESERVED 
bits not zero for EXTRACT request. 

Unable to locate SVC Routine in the 
SVC Table for an "EXTRACT” 
request• 

Program check suffered while attempting 
to update SVC Table. 


EXIT ERROR 

: 


Decimal 

Hexadecimal 

Reason 

Code 

Code 


04 

04 

Missing Required parameters. 

28 

1C 

Unable to locate Entry Point Address 
for an EPNAME specification. 

ENTRY POINT 

IEAVESTR: None 



REGISTER CONTENTS ON ENTRY: 

ENTRY POINT IEAVESTU: 

1 Address of SVCUPDTE parameter list 

13 Address of 18 word save area 

14 Return Address 

15 Entry Point Address 

ENTRY POINT IEAVESTEs 

1 Address of SVCUPDTE parameter list 

13 Address of 18 word save area 

14 Return Address 

15 Entry Point Address 

ENTRY POINT IEAVESTR: Irrelevant 


REGISTER CONTENTS ON EXIT: 

ENTRY POINT IEAVESTU: 

EXIT NORMAL: 

0 Unchanged for "REPLACE/DELETE” request 
SVC number for "EXTRACT” request 
1-13 Unchanged 
14 Return Address 
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XEAVESTU - DIAGNOSTIC AIDS (Continued) 

15 Zero 

ENTRY POINT IEAVESTE s 
EXIT NORMAL: 

0 Entry point address 
1-13 Unchanged 

14 Return Address 

15 Zero 

ENTRY POINT IEAVESTR: Irrelevant 
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SUP-39. Dynamic SVC Table Entry Installer (IEAVESTU) 

IEAVESTU - DYNAMIC SVC TABLE UPDATE SERVICE STEP 


(via SVCUPOTE macro interface) 
IEAVNP25, IEAVNPS5, IEAVNPST 


Any supervisor state/key zero 
routine 


c> 

IEAVESTU 


PSA 

FLCCVT 

CVT 


CVTABEND 


SVCTABLE 

--.-J 


SVCURTE 


IHASVCT 


SVCUPLST 

SCVT 


SCVTSVCR 

IHASVCT 

SVCUPVER 


IHASVCT 

ISVCUPNUM 


IHASVCT 

IsVCUPFUN 


J\ 

V 


> 


■> 


■> 


IHASVCT r-> 

SVCUPFG1 I 


IHASVCT r -> 


SVCUPVER SVCUPEP 
SVCUPTP SVCUPN8 


IHASVCT j-> 

ISVCUPVER I 


The SVC Dynamic Update Service updates 
entries in the System SVC Table for 
11 REPLACE/DELETE 11 requests. The old SVC 
Table Entry and other data about the 
update request is stored in the SVC Update 
Recording Table. It returns information 
from the SVC Table for "EXTRACT" requests. 



Setup addressability and 
Verify authority of caller 


A. IF Caller is AMODE 24 Then clear 
high-order byte of parameter list 
pointer and savearea pointer 


02 


Validity check input 
parameter list 


A. Verify 
r number 


that parameter list version 
is current 


B. Verify that SVC is not reserved for 
r extended SVCs 


A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 


03 


Validity check REPLACE 
parameter list 


A. Verify that SVC number supplied 


B. IF Type 5» Verify that no 
r Entry-Point Operand supplied 


C. ELSE Validity check entry-point 
|—| parameter 
D 

D| D. IF Version 1 Check EP 
D 
D 
D 
D 


C7l 

\ / 

171 


171 
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IHASVCT 


IHASVCT 


IHASVCT 


ISVCUPEP SVCUPN8 



I. ELSE Version Z or greater. Check 
EP/EPNAME 

I. IF Both parameters 
r inconsistent 


STEP 03E 


in 

\ / 

>n 

\ / 

F71 

\ / 

in 


IHASVCT 


IHASVCT 


IHASVCT 


IHASVCT 


SVCUPA1 SVCUPR12I 


IHASVCT 


IHASVCT 


IHASVCT 


SVCUPTP SVCUPA2 


ELSE either EP or EPNAME 
IF EP supplied insure EP 
is not zero 


H K. insure halfword boundary 

H r 
H 

H 


E F G L. ELSE EP not supplied IF 
i E F G EPNAME not supplied 

i E F G missing required parameter 

EFG 

M. RESERVE BITS CLEAR? RESERVED BYTE 
r CLEAR? Verify that reserved bits 
are clear 


N. EXTRA LOCK BITS CLEAR? VERIFY NO 
r EXTRA LOCK BITS SET 


0. Verify that SVC Type is valid 


P. If Type 6 request> Verify that 
r no locks are requested 


in 

\ / 

|tn 

\ / 

p 

\ / 

\ / 

\ / 

in 

\ / 

'in 
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IHASVCT 


SVCUPTP 

SVCUPLL 

SVCUPA2 

SVCUPCMS 


IHASVCT 

J 

SVCUPFG1 


IHASVCT 

J 

SVCUPEP 

SVCUPTP 


SVCUPA1 

SVCUPA2 


|SVCUPR12 


IHASVCT 

J 

SVCUPVER SVCUPN8 


IHASVCT 

J 

SVCUPVER 


IHASVCT 

J 

SVCUPEP 

SVCUPN8 



IHASVCT 


SVCUPEP 


IHASVCT 

J 

SVCUPEP 


IHASVCT 

J 

SVCUPN8 


IHASVCT 

_r 

SVCUPFG1 


IHASVCT 

j' 

SVCUPTP 

SVCUPA2 

SVCUPA1 

SVCUPR12 



I_ILL 


04 


Validity check DELETE 
parameter list 


A. Verify that SVC number supplied 


B. ”EP” NOT FILLED IN? SVC TYPE NULL? 
ATTRIBUTE FIELD NULL? LOCK FIELD 
NULL? RESERVED FIELD NULL? Verify 
that the rest of the parra list is 
clear 


05 


Validity check EXTRACT 
parameter list 


A. IF Both parameters inconsistent 


ELSE either EP or EPNAME IF EP 
supplied insure EP is not zero 



E D. ELSE EP not supplied IF EPNAME 
E r not supplied missing required 
E parameter 
E 

E. Verify that no SVC number is 
supplied 


06 


F. SVC TYPE NULL? ATTRIBUTE FIELD 
r NULL? LOCK FIELD NULL? RESERVED 
FIELD NULL? Verify that extra bits 
are clear 


OTHERWISE Return code for 
invalid funtion 


\ / 


[71 

\ / 

T 1 

\ / 

T 1 

\ / 

[71 

\ / 

[71 

\ / 

[71 
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IHASVCT 


SVCUPFUN 


IHASVCT 


SVCUPEP 


IHASVCT 


SVCUPEP 


SCVT 


SCVTSVCT 


J-T 


SVCTABLE 


SVCEP 


SVCTABLE 


SVC ENTRY 


■J\ 

V 


J\ 

V 


07 Perform EXTRACT Processing 


A. IF "EP M not supplied DO "EPNAME" 
processing 

B. Call interface to Nucleus search 
routine 


NUC: 15 


C. L:IF not successful CALL LPA 
search routine 

D, IF unsuccessful Return error 
code 


E. ELSE Load entry point 


F. ELSE load Entry point 


D 


G. DO for each SVC Table Entry 

H. IF SVCEP matches search argument 
I, Return to caller 


J, ELSE increment entry pointer 

m 

K. IF scan complete and no match 
return error code 


08 


Perform DELETE Processing 


A. When DELETE request 

B. Set Entry to IGCERROR 

C. SET Attributes for TYPE 2 


Tl 


\ / 

[71 


07 
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IHASVCT 


SVCUPTP 


IHASVCT 


SVCUPEP 


IHASVCT 


SVCUPTP 


IHASVCT 


SVCUPEP 


IHASVCT 


SVCUPTP 


IHASVCT 


SVCUPAPF 


IHASVCT 


SVCUPNPR 


IHASVCT 




SVCUPTP SVCUPLL 


JT 




09 Perform REPLACE processing 


A. IF Type 5 request Set Entry to 
r IGCRETRN 


B. ELSE Process entry-point operand 


C. IF "EP” not supplied Process 
"EPNAME" 


D. IF Type 3/4 request 


E. CALL LPA search routine 

/i—i\j- 

\l-1/ LPA: 17 


F. IF Entry point not found 
Return error code 


> ELSE Nucleus-Resident IType 1» 
2, or 6) 

H. Call interface to Nucleus 
search routine 
/'-- 


NUCs 15 


I. IF Entry point not found 
Return error code 


J* ELSE load Entry point address 
-i from “EP 11 field 


10 


Set on Attribute bits 
in new SVC Entry 


A. Set TYPE Bits 


B. IF requested Set APF bit 


C. IF requested Set NPRMPT bit 


D. IF LOCAL lock required or TYPE 1 
routine set LOCAL lock bit 




\ / 


■71 


\ / 


09 
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STEP 10E 


IHASVCT 


E. IF requested Set CMS lock bit 


ISVCUPCMS 


IHASVCT 


F. IF requested Set SRM lock bit 


ISVCUPSRM 


IHASVCT 


6. IF requested Set SALLOC lock bit 


ISVCUPSAL 


IHASVCT 


H. IF requested Set DISP lock bit 


SVCUPDSP 


1 Set on ASSIST bit in new SVC 
— 1 Entry 

A. IF SVC is not APF authorized not 
NON-Preemptive IF only LOCAL Lock 
required IF TYPE 2 or 3 or 4 THEN Set 
Assist bit 


12 Update SVC Table Entry 


K A. Get CPU Lock 



IHASVCT 


SVCUPNUM 


SETLOCKI 


(OBTAIN) TYPE!CPU) RELATED!'Released after 
update attempt 1 ) 



B. Copy Caller's savearea addr. 

C. SAVE new SVC Table entry 


D. Index into SVC Table 


PSAMPSW 

PSACPUL 

PSACPULI 


IPSACSTK 
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STEP 12E 


SVCTABLE 


-> E. Index into SVC Update Recording Table 

i\ 

i/ 


ISCVTSVCR 


IHASVCT 


ISVCUPNUM 


SVCTABLE 


ISVCENTRY 


SVCTABLE 


SVCENTRY 


J \ F. Load Real address of target 

V 

G. Load Target data 

H. DO Compare Double & Swap Until it goes 


SVCTABLE 


ISVCURCNT 


J \ A I. ADD I to change counter and save in 
l/ A FRR parameter area 

A 

A J. Save old SVC entry in FRR parameter 
A area 



PSASUPER PSACLHS 


PSACPUL 


K. Clear Suffix Field (only set by SVC NIP 
RIM 


L. Copy update information to SVC Update 
Recording Table Entry 



M. Release Lock 


SETLQCKI 


(RELEASE) TYPE(CPU) RELATE0('Obtained 
before update attempt') 


N. Normal Exit for DELETE or REPLACE — 
Return Code=0 


171 


KSVCTABLE 

- 

SVCURDAT 

KSVCTABLE 

1/1- 

SVCURRET 

SVCURCNT 

SVCURSX 

KSVCTABLE 

i / \ - 

SVCUROLD 

SVCURNEW 



PSACSTK 

\PSA 

Ipsanss 


PSAMPSW 

PSACPUL 

PSACPULI 
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STEP 13 


PSASUPER PSACLHS 


RETRY l 13 RETRY Point when ZEAVESTU 
1 — 1 suffers an error while 
holding CPU lock 

A. RETRY: Assume SVCTABLE update failed 

B. IF FRR determined that update 

completed* THEN setup zero return code 



->| C. Release Lock 




SETLOCKZ 


(RELEASE) TYPE(CPU) RELATED!'Obtained 
before update attempt•) 


\PSA 

Ipsanss 


PSAMPSW 

PSACPUL 

PSACPULI 


D. return to caller of IEAVESTU 


[71 


IEAVNPS5 IEAVNPST 


C> 0 


ZEAVESTE entry 


ZEAVESTE 


A. CALL LPA Search Routine 

/I-K.- 

\i-1/ LPA: 17 


B. IF Entry point not found 


tn 


C. ELSE Successful 
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STEP 15 


PSA 


PSASUPER PSACLHS 


PSA 


PSACPUL 


-»\ 


15 


V 

NUC 

—»\ 
l' 


PSACPUL | 


PSA 


qqBRHI 

IHASVCT 

J- 

SVCUPNM 


PSA 

_J -' 

PSACSTK |-1 

PSA 

j~~------ 


V 


V 


151 Nucleus Search Routine 


A. Get CPU Lock 


SETLOCKI 


(OBTAIN) TYPE(CPU) RELATED)'Released after 
call to IEAVENLU 1 ) 


B. Copy Caller's savearea addr. 

C. Copy forward savearea addr. 

D. Chain saveareas 

E. Setup new savearea pointer 

F. Unchain Saveareas 

G. Clear forward savearea addr in FRR 
parameter area 


H. Release Loc 


SETLOCKI 


(RELEASE) TYPE!CPU) RELATED!'Obtained 
before call to IEAVENLU') 


I. IF search unsuccessful RETURN to caller 

[ of this subroutine indicating Entry 
point address not found 

J. ELSE Setup entry point address in 
I—I ENTRYEP 
A 

A K. RETURN to caller of this subroutine 
A indicating Entry point address was 

A found 


\ / 


\ / 


-KPSA 
Vi 


PSAMPSW 

PSACPUL 

PSACPULI 


->PSA 


PSACSTK 


->PSA 


PSACSTK 


U\PSA 


PSANSS 


-KPSA 
Vl 


PSAMPSW 

PSACPUL 

PSACPULI 
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RETRY2 



RETRY Point when IEAVESTU 
suffers an error while 
holding CPU lock to call 
IEAVENLU to obtain an entry 
point address 


A. IF a savearoa Mas GETMAINED release the 
r storage 



PSA 


FLCCVT 


CDE 


COCHAIN 


CDE 


CONAME CDEANYM 


IHASVCT 


SVCUPNM 


CDE 


CDENTPT 


IHASVCT 


SVCUPNI SVCUPN2 


17 




J - *" 


> 

"V 

LPA 
—1\ 

—(/ 


V 


—> 
J\ 
V 


J\ 

V 


17 LPA Search Routine 


A. Scan Active CDE Chain 


B. IF CDNAME matches Load Entry point 
data into Register Zero 


C. IF Routine not found invoke Directory 
Search Routine (IEAWMSR) 

D. IF Successful setup addressability to 
LPDE 
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IEAVESTR 
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STEP 18E 


K a| e. else recovery entered while attempting 


SVCTABLE 

SVCENTRY SVCURTE 


JSCVTSVCT SCVTSVCR j 

IHASVCT 


ISVCUPNUM 


SVCTABLE 


SVCENTRY SVCURNEHI 


B 
B 
B 
B 
B 
B 

-> A B — 
K A B C 
1/ A B C 
ABC 
ABC 
ABC 
ABC 
ABC 
ABC 
ABC 
ABC 
ABC 
->ABC 



F. IF entries in SVC Table and SVC 

r Update Recording match requested 
update> then setup retry to return 
code zero 


KSVCTABLE 


SVCUROLD 

SVCURRET 

SVCURNEH 

SVCURDAT 

SVCURCNT 


G. ELSE setup retry to return error 
—1 code 


H. Exit to RTM 


KSDWA 

1/1 - 

SDWASR12 

SDWASR13 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part 1 of 14) 


Input 


From SVC new PSW 
after hardware 
stores SVC old PSW 


Process 
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\ 
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to 


to 
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(0 
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ro 

oo 

1 


Os 
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to 

3" 


PSA 



PSA 


FLCSOPSW 


FLCSVILC 


FLCSVCN 


PSASTKE 


a 


3 


O 

o 

■o 


sO 

oo 


IEAQSC00 


Initialize the recovery 
environment. 


2 Determine if the requestor is 
authorized to issue SVCs. 


• If not 


3 Save the registers and 
trace the initial SVC 
interrupt. 


4 Save the PSW t interruption 
code, and instruction length. 


6 


Output 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part 2 of 14) 

Extended Description Module Label 

The SVC interrupt handler sets up the proper operating 
environment for a requested SVC (supervisor catl) by 
obtaining any necessary locks and initializing registers. 

The SVC interrupt handler routes control to the appro¬ 
priate SVC routine after setting up the operator's IEAVESVC IEAQSC00 

environment. 

1 The SVC first level interrupt handler (FLIH) copies 
the SVC code to PSALSVCI (this field is used as a 

check against recursive ABEND loops), saves the current 
FRR stack pointer (PSACSTK) in the PSASSAV field, makes 
the super FRR stack current, and sets the SVC super bit 
(PS AS VC) to 1. 

2 Programs in the disabled state, in cross memory 
mode, in enabled unlocked task mode with an FRR, 

in non-task mode, or holding locks cannot issue SVCs. 

If one does, the SVC FLIH clears PSALSVCI„and passes 
control toRTM, which then terminates the caller with 
an ABEND code of X'0F8\ 

3 For type 1 and type 6 SVCs the SVC FLIH saves the 
SVC issuer's registers in the TCBGRS field; for type 

2, 3 and 4 SVCs, it saves the registers in the SVRB ob¬ 
tained by the SVC FLIH. It traces the SVC interrupt. 

Additionally, the SVC FLIH uses the generalized trace 
facility. 

4 The SVC FLIH saves: 

• The PSW in the RBOPSW field. 

• The interrupt code in the RBINTCOD field. 

• The instruction length in the RBINLNTH field. 

• Cross memory control registers 3 and 4 In the 
XSBXMCRS field. 

• The PCLINK stack header in the XSBSTKE field. 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part 3 of 14) 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part 4 of 14) 

Extended Description Module Label 

g Each SVC has an entry describing its attributes (entry 
point of the SVC routine, addressing mode of the SVC 
routine, type, whether the SVC routine requires APF 
authorization or locks) in one of three tables: the SVC 
screening table, the system SVC table, or the extended 

SVC routine (ESR) table. IEAVESVC locates the entry 
to user later when establishing the environment required 
to invoke the service routine. To locate the appropriate entry, 

IEAVESVC does the following in the order specified. 

• If SVC screening is active (TCBSVCS-1), IEAVESVC 
determines whether the SVC issuer is allowed to issue 
the SVC (that is, whether the SVC is being screened). 

To make the determination, IEAVESVC uses the SVC 
number to index into the task's SVC screening table 
(pointed to by the TCBSVCA2 field), which contains 
a flag for every SVC indicating whether the task can 
issue the SVC. If the SVC C8nnot be issued, 

IEAVESVC processes instead the SVC request des¬ 
cribed in the first doubleword of the screening tsble. 

The doubleword contains the information normally 
obtained from the system SVC table. 

• If SVC can be issued, I EAVESVC uses the SVC num¬ 
ber to locate the appropriate entry in the system SVC 
table. Unless the attributes indicate that it is an 
extended SVC (either SVC 109, 116,122, or 137) 

(SVCESFM), IEAVESVC uses this information when 
preparing to invoke the service routine. 

• If an extended SVC is being processed, the first word 
of the SVC table entry points to an ESR tsble. 

IEAVESVC uses the extended SVC route code in 
register 15 to locate the appropriate entry in the 
ESR table. 

6 If the table entry information indicates that the SVC 
can be issued only by users with APF authorization 
(SVCAPF°d), the SVC FLIH issues a TESTAUTH macro 
to determine if the user is authorized. If the TESTAUTH 
return code is nonzero, the user is not authorized. In this 
case, the SVC FLIH calls RTM to abnormally terminate 
the user with ABEND code X'047\ It then exits to the 
dispatcher at entry point IEA0DS1. 
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Diagram SUP-40. SVC Interrupt Handier (IEAVESVC) (Part 5 of 14) 
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PSA 


PSANSTK 


3 


5 


Check for a non-praampttbta SVC. 
If It li t make the teak non* 
preemptible. 


8 Check the SVC type. 

• For e type 1 SVC, continue et 
the next step. 

• Fore type 2,3, or 4 SVC I 

e For e type 6 SVC a 


Type 1 SVC Proossslng 

9 Obtain the LOCAL lock. 


If the lock is not obtained 
Immediately, indicate the local 
is required, alter the PSW, 
reissue SVC instruction and 
exit to dispatcher. 


10 Indicate type 1 SVC processing. 


11 Make the normal FRR stack tha 

current one, enable for Interruptions, 
and obtain any locks needed by 
the SVC routine. 


O 
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Diagram SUP-40: SVC Interrupt Handler (IEAVESVC) (Part 6 of 14) 

Extend*! Description Module Label 

7 If the SVC is Ron-preemptible (SVCNP-1), the SVC 
FLIH makes the task non-preemptible (TCBNONPR-1). 


8 Based on the SVC type, the SVC FLIH branches to the 
appropriate processing routine. Note the! steps 11 
end 12 show processing common to SVC types 1,2, 3, 
and 4. 


SVCtyp* Steps 

1 9-12 

2. 3.4 13,14,11,12 (in that order) 

6 17-19 

Type 1 SVC Processing 

g To process type 1 SVCs, the SVC FLIH obtains the local 
lock. The local lock request is made conditionally, since 
the SVC FLIH cannot be suspended (see lock manager rout¬ 
ine, IEAVESLK). If the local lock is obtained, operation con¬ 
tinues at step 10. 

Otherwise, the SVC FLIH sets the high order bit of 
ASCBLSQH to indicate suspended on the local lock. 

This causes the lock manager to get control when the lock 
Is released. The SVC FLIH then changes the RBOPSW in 
the requester's RB to point to tha SVC instruction so 
that, when the requester is redispatched, the SVC is 
reissued. The SVC FLIH passes control to the dispatcher 
at entry point IEA0DS1 to redispatch the requester 
when the lock is available. 

10* The SVC FLIH indicates type 1 processing in the 
ASCBFLG1 field, bit ASCBTYP1. 

11 The SVC FLIH turns off the SVC super bit 

(PSASVC°0), makes the normal FRR stack the cur¬ 
rent one, and enables the PSW for I/O and external inter¬ 
rupts. The SVC FLIH now sets the operating environment 
for the requested SVC routine. First, the SVC FLIH ob¬ 
tains any locks that the SVC routine needs, as indicated in 
the SVC table entry. 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part 7 of 14) 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part 8 of 14) 


Extended Description Module Label 

12 THE SVC FLIH sets the proper values in input registers 
used by the SVC routine, and gives the SVC routine 

control using the entry point address in the SVC table en¬ 
try. Registers 0,1,13 and 15 contain the same value as 
when the requester issued the SVC. If the high order bit of 
the entry point address (SVCEP) is a 1, the SVC receives 
control in 31 bit addressing mode; otherwise, the SVC re¬ 
ceives control in 24 bit addressing mode. 

-Types 2,3, and 4 SVC Processing 

13 Because type 2,3, and 4 SVC routines can be inter¬ 
rupted, the SVC FLIH obtains an SVRB/XSB pair 

in which to save status if interrupted. The SVC FLIH 
attempts to remove an SVRB/XSB from the pool chain¬ 
ed from the ASCBSVRB field. If no pool elements are 
available (ASCBSVRB°0), the SVC FLIH issues a , 

GETMAIN to expand the pool. If that GETMAIN falls, 

IEAVESVC attempts to get a single SVRB/XSB pair. 

If that fails, IEAVESVC calls RTM with ABEND code 
X'0F9\ reason code 0. If the pool is obtained, 

IEAVESVC initializes it, queues it to the ASCBSVRB 
pool, and removes one of the available SVRB/XSB pairs. 

14 The SVC FLIH: 

• initializes the SVRB. 

• Moves the issuer's registers from the TCBGRS field 
into the RBGRSAVE field in the SVRB. 

• Copies the ASCBSRBM value into the first byte of the 
RBOPSW to properly propagate PER monitoring. 

b If the SVC is type 3 or 4, indicates so by setting the 
RBTRSVRB bit to one. 

• Adds the SVRB/XSB to the task's RB/XSB queue. 

• Sets the TCBATT bit to one to suppress attentions. 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVQ (Part 9 of 14) 
Input Process 


PSA 


FLCCVT 


PSA 


PSAAOLD 


PSAXMFLG 


PSASEL 


PSAXMPAS 


ASCB of home 
l address space 


ASCBASID 


Register 1 


SRB 


a 


R egister 2 

code specifying 
where to return 
control 


9 


Type 6 SVC Processing 

15 Prepare the registers for a type 
6 SVC routine. 


* 


16 If the SVC routine changed the 
cross memory environment, re¬ 
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17 


Give control to the routine 
indicated by the code in 
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a. RETURN e CALLER or BR14 

• Save the registers in the TCB 
e Dispatch the task. 

b. RETURN-DISPATCH 

• Exit to the dispatcher. 

c. RETURN-SRB 

• if there is no SRB in this 
address space 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part 10 of 14) 

Extended Description Module Label 

Type 6 SVC Processing 

15 The type 6 SVC processor sets the type 6 super bit TYPE6SVC 

(PSATYPECM) to indicate that a type 6 SVC is in 

control, and sets up the input registers for the type 6 SVC 
routine, it then branches to the routine. When the routine 
finishes executing, it returns control to this point in the 
SVCFLIH. 

16 Because the SVC FLIH executes with the primary and se 
condary address spaces equal to the home address 

space (PASID=SASID«HASID), after the SVC routine 
returns, the SVC FLIH checks whether this cross memory 
state still exists: 

• If the SVC routine was executing in secondary mode, the 
SVC FLIH issues a SAC instruction to reestablish primary 
addressing mode. 

• If the SVC routine changed the cross memory state, 
the SVC FLIH issues a CMSET SET macro to reestablish 
the home address space as both the primary and second¬ 
ary address space. 

• If the PCLINK stack is not empty, the SVC FLIH issues a 
PCLINK PURGE macro to free atl the stack elements. 


IEAVET6E 

and 

IEAVTY6C 


Extended Description Module Label 

17 Register 2 contains a code indicating to whom the SVC • EAVET6E 

FLIH is to give control. The return options are: 

a. RETURN=CALLER or BR14. The SVC IH saves re¬ 
gisters 0,1, and 15 in th8 TCB and exits to the exit 
Prolog, which directly re*dispatches the task. 

b. RETURN=DISPATCH. The SVC FLIH gives control to 
the dispatcher at entry point IEA0DS1. 

c. RETURN°SRB. The SVC FLIH checks whether there is 
an SRB scheduled for this address space. If there is no 
SRB, it issues an ABEND. If there is an SRB, the SVC 
FLIH saves the task status (floating point registers and 
timing data), performs the job step timing functions, 
takes the task out of task mode, and calls the global 
SRB dispatcher routine (entry point DSSRBRTN in 

the dispatcher) to directly dispatch the specified SRB. 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part 11 of 14) 
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18 Terminate a caller that issues 
an invalid SVC. 

• Issue an ABEND for SVC 
types 1,2, 3, or 4. 

• Issue an ABEND for SVC 
type 6. 


IEAVESVR (SVC recovery routine) 

19 Determine if this is a recursive entry, 
or if the last SVC was an ABEND. 

If not: 

• Issue an ABEND for SVC _ 

types 1,2, 3, or 4 —I I 

• Issue an ABEND for SVC | | 

type 6. I " | I 




so 

oo 
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Output 
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To RTM to 
terminate 
the caller 


ABEND code 


X'Fxx' — xx equals the SVC 
number 

ABEND 
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Normal 
FRR stack 



Completion code 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part iZof 14) 

Extended Description Module Label 

Recovery Processing 

18 The IGCERROR entry point receives control when the IGCERROR 

requester issues an SVC not listed in the SVC table. 

This routine terminates the requester with a code of X'Fxx 1 , 
where xx is the number of the invalid SVC. The IGXERROR 
entry point receives control when the requester issues an invalid 
extended SVC. This routine terminates the requester with a 
completion code of X f 16D'. 

19 The SVC FLIH FRR (functional recovery routine) IEAVESVR 

tests for a recursive entry and checks field PSALSVCI 
to determine if the last SVC processed was an ABEND. 

(This field is set by IEAVESC and is used to handle a 
recursive ABEND situation.) If both tests fail, IEAVESVR 
clears the SVC indicator in the PSA, and sets the FRR stack 
pointer to the normal stack. If the SVC type was 
type 1, 2,3, or 4, then this routine terminates the 
caller with a completion code of X'l FC\ If the SVC 
type was 6, it passes the original completion code 
issued by the type 6 SVC to the caller. 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part 13 of 14) 
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Diagram SUP-40. SVC Interrupt Handler (IEAVESVC) (Part 14 of 14) 

Extended Description 


20 Process recursive or loop situation. 

• If recursion is detected, the system terminates. 
System termination prints an IEA740W message 
{Supervisor unable to recover from SVC D loop) 
at the console. 


• If the last SVC was an ABEND, IEAVESVR terminates 
the address space. The MEMTERM completion cole is 
X'07C' with a reason code of X'04\ 
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Diagram SUP-41. SUSPEND Service Routine (IEAVETCL) (Part 1 of 2) 
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mask. 
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Diagram SUP-41. SUSPEND Service Routine (IEAVETCL) (Part 2 of 2) 

Extended Description Module Label 

When a SUSPEND macro is issued, IEAVEGLU receives 
control at entry point IEAVSPND, converts to 31 bit 
addressing mode and branches to IEAVETCL at entry 
point IEAVSPN1. (Return will be made directly to 
the issuer of the SUSPEND macro.) The function 
performed at IEAVSPN1 is to place an RB in a 
suspended state. 

1 IEAVETCL issues a CMSET SET macro to obtain IEAVETCL IEAVSPN1 

addressability to the home address space of the 

RB being suspended. This is the address space pointed 
to by PSAAOLD. 

2 IEAVETCL cannot suspend the RB if: 

• The RB suspend count (RBSCF) is nonzero. 

• The caller requested that tha previous RB be suspended, 
but no previous RB exists. 

In either case, IEAVETCL terminates the caller with 
ABEND X'070* and reason coda 48 or 62, respectively. 

3 When suspending the current RB, IEAVETCL: 

• Subtracts one from the count of unlocked, ready TCBs 
(ASCBTCBS). (This Is done because the TCB is not 
dispatchable when tha top RB is suspended.) If this 
makes the count of ready TCBs (both unlocked TCBs 
and those requiring the local lock) zero, IEAVETCL 
adds one to the short wait count (ASCBSWCT) and 
time stamps the wait time. 

a Sets the RB's suspend count to one. 

To suspend the previous RB, IEAVETCL sets the RB's 
suspend count to one. Since tha TCB Is still dispatchable, 
no additional processing Is required. 

4 IEAVETCL issues e CMSET RESET macro to 
restore the caller's cross memory state. It puts the 

target TCB's address Into register 0, the suspended RB's 
address into register 1, and returns to the caller. 

Recovery Processing 

When entered to process a SUSPEND macro, IEAVETCL 
doqs not establish Its own recovery environment. 
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Diagram SUP-42. TCTL Service Routine (IEAVETCL) (Part 2 of 6) 


Extended Description Module Label 

When a TCTL macro is issued, IEAVEGLU receives control 
at entry point IEAVTCTL, converts to 31 bit addressing 
mode, and branches to IEAVETCL at entry point 
IEAVTCT1. IEAVETCL transfers control directly to 
the specified TCB. SRBs that dispatch an associated TCB 
on exit use this service as a performance path. The 
RESUME service routine also invokes IEAVETCL when 
an SRB issues a RESUME macro requesting that 
control be given to the resumed TCB/RB after the 
resume function is completed. In this case, the RESUME 
service routine branch enters IEAVETCL at entry point 
JOINTCT. 

At entry, register 4 points to the TCB to be given control. 

1 IEAVETCL sets PSW key zero and disables the pro- IEAVETCL IEAVTCT1 
cessor for I/O and external Interrupts. 

2 For the request to be valid, the caller must be an 
unlocked SRB In home addressing mode with an 

empty PCLINK stack. (IEAVETCL will flush the PCLINK 
stack if it is not empty.) If it is not, IEAVETCL terminates 
the caller with ABEND X*070' and an appropriate reason 
code. (See System Codes for specific reason codes.) 

3 IEAVETCL makes the dispatcher-l/O-SVC super FRR 
stack the currant one and sets to one the dispatcher 

and TCTL super bits (PSADISP and PSATCTL). As a result, 
if the TCTL service routine Issues an ABEND, tha super¬ 
visor's recovery routine (IEAVESPR) routes control to 
IEAVETCR,an PRR entry point within IEAVETCL. (See 
"Recovery Processing" for a description of IEAVETCR.) 

4 To serialize the dispatch function. IEAVETCL: IEAVETCL 

• Puts the processor's logical address in the appropriate 
dispatcher active byte (SVTDACTV). This prevents 
STATUS from changing the TCB's dispatchability. 

• Ensures that no other functions are intersecting with 
the dispatcher. I^elther the global or local intersect 
word (SVTDSREQ or ASCBSRQ) is nonzero, 

IEAVETCL cannot perform the TCTL function. It 
clears the dispatcher active and super bits and returns 
to the dispatcher's SRB exit routine (entry point 
IEAPDSRT). 


Extended Description 


Module 


Label 


IEAVETCL attempts to serialize the TCB with the dll- GETXSCT3 

patcher, STATUS, and the stage 3 exit effector by 
setting the TCB active and stage 3 exit effector/TCTL 
Intersect flags (TCBACTIV and TCBS3A). It uses a com¬ 
pare and swap Instruction to do so. If the instruction 
falls because the intersect flags are already on, IEAVETCL 
cannot complete TCTL processing. It clears the dispatcher 
active and super bits and returns to the dispatcher's SRB 
exit routine (entry point IEAPDSRT). 
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Diagram SUP-42. TCTL Service Routine (IEAVETCL) (Put 4 of 6) 

Extended Description Modulo Libel 

5 IEAVETCL cheeks the following conditions to deter* JOINTCT 

mint whether the TCB/RB can be dispatched. 

• No TCB dUpatchabiUty ftaos era sat 

• Tha top RB b not waiting or suspended 

• Tha TCB does not have affinity to a processor other 
than tha one executing IEAVETCL 

a Tha address space pointed to by tha P8AANEW field 
does not have higher priority than tha currant address 
space 

If any of these concBtlons is not mat, IEAVETCL cannot 
transfer control to the TCB/RB. It clears tha TCB Inter¬ 
sect flags, tha dispatcher active flag, and tha super bits, 
and returns to tha dispatcher's 8RB exit routine (entry 
point IEAPDSRT). 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 



Diagram SUP-42. TCTL Service Routine (IEAVETCL) (Part 5 of 6) 
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Diagram SUP-42. TCTL Service Routine (IEAVETCL) (Part 6 or 6) 

Extended Description Module Label 

g Create a mask of eligible processors for the dispatch of 
the input TCB. If the task requires a processor with a 
vector facility, the mask is based on CSDCPUVF and 
STCBAFNS. If the resulting mask is 0, exit immediately 
to the dispatcher at IEAPDSRT, the SRB exit address. 

Otherwise, store the mask in TCBAFFN. If a vector 
facility is not jequired, the mask is based on TCBAFFN, 

TCBNDAXP and CSDAXPAL. 

7 The physical processor address mask (PCCACAFM), 
is logically ANDed with the eligible processor mask 

computed in step 6. If the current CPU is eligible, 

1. • Jobstep timing is invoked at entry point DSJSTSRB 

2. • IEAVETCL does the following: 

• —Sets PSAANEW to the ASCB address of the 

home address space 

• —Sets to zero the processor's SRB mode flags, 

SVTDACTV, TCTL, and dispatcher superbits 

• —Branches to dispatcher entry point IEAVDSTC 

to give control to the specified TCB. 

8 IEAVETCL performs the following: 

• Sets up the interface to memory switch using TCBAFFN 
and TCBNDAXP or STCBVAFN and STCBAFNS. 

• Sets the TCTL superbits, TCBACTIV and TCBS3A 
to zero. 

• Sets the SVTDACTV intersect byte for the current 
processor to zero. 

• Sets up register 14 with the SRB return address in 
the dispatcher. 

m Gives control to memory switch entry point 
(IEAVEMS9). 


Extended Description Module 

-Recovery Processing 

When an error occurs while IEAVETCL Is performing 
TCTL services, RTM gives control to the supervisor control 
FRR (IEAVESPR). IEAVESPR routes control to IEAVETCL IEAVESPR 
at entry point IEAVETCR. IEAVETCR: IEAVETCL 

• Records diagnostic information in the SDWA and the 
SDWA variable recording area 

• Sets to zero the TCBACTIV and TCBS3A flags in the 
input TCB, the executing processor's dispatcher active 
byte (SVTDACTV), and the TCTL and dispatcher 
super bits 

• Returns to IEAVESPR, which retries at label IEAVEDSE 
within IEAVEDSR. 


Label 

IEAVETCR 

TCRACTV 
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Diagram SUP-43. RESUME Service Routine (IEAVETCL) (Part 2 of 6) 

Extended Description Module Label Extended Dertriptfon Module Label 


When a RESUME macro is issued, IEAVEGLU receives 
control. It converts to 31-bit addressing mode and 
branches to IEAVETCL at the appropriate entry 
point. (See SUP-36 for the correspondence between 
the RESUME entry points in IEAVEGLU and 
IEAVETCL.) IEAVETCL receives control to remove 
a specified RB from a suspended state. IEAVETCL 
tries to do this synchronously. If unsuccessful be¬ 
cause the required serialization is not available, 

(EAVETCL's actions depend on the type of RESUME 
macro being processed. The types and I EAVETCL's 
corresponding actions are listed below. Note that the 
request type refers to the action IEAVETCL takes 
after It has determined that it cannot perform the 
resume function synchronously without further ser¬ 
ialization. 

• A conditional synchronous RESUME — Bypasses 
the resume function and returns to the caller. 

• An unconditional synchronous RESUME — Obtains 
the local lock of the target address space and com¬ 
pletes the resume function before returning control 
to the caller. 

• A conditional asynchronous RESUME — Condition¬ 
ally obtains an SRB and schedules it to complete the 
resume function asynchronously. If no SRB Is avail¬ 
able, IEAVETCL does not complete the function 
(no GETMAIN is issued). 

• An unconditional asynchronous RESUME — Obtains 
an SRB and schedules it to complete the resume 
function asynchronously. IEAVETCL might have to 
issue a GETMAIN to allocate the SRB. 

At entry, register 6 points to the RB to be resumed 
(the target RB), register 4 points to the TCB from which 
the RB Is chained, and register 1 contains the ASCB 
address of the target RB's home address space. 

1 IEAVETCL disables the processor for external and COMMON 

I/O interrupts to prevent the address space in which 
the target RB resides from being swapped out 


2 IEAVETCL checks the resume request to determine 
if: 

• The caller has established current addressability to CHKASCB 

the address space in which the suspended RB and 

task reside. If not, IEAVETCL issues ABEND X'070' 
with reason code 20. 

• The TCB acronym b valid. If ft is not, IEAVETCL 
issues A8END X'070' with reason code 16. 

• The RB suspend count (RBSCF) is nonzero. If the 
suspend count is zero, the RB is not suspended and 
IEAVETCL exits at step 6. If the suspend count is 
greater than 1, IEAVETCL issues ABEND X*070’ 
with reason code X f 56\ 

IEAVETCL also checks whether the RB's address is 
valid by making a dummy reference to the RB. If the 
RB address is Invalid, the reference causes a program 
interrupt. 

3 IEAVETCL puts an FRR on the current FRR stack 
and sets to one the TCTL super bit. This allows 

the RESUME/TCTL recovery routine (IEAVETCR) to 
receive control disabled when an error occurs. See 
"Recovery Processing" for a description of IEAVETCR. 
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Diagram SUP43. RESUME Service Routine (IEAVETCL) (Part 4 of 6) 

Extended Description Module Label 


4 IEAVETCL attempts to serialize the TCB with the IEAVETCL GETXSCT1 

dispatcher, STATUS, and stage 3 exit effector by 
setting the TCB active and stage 3 exit effector intersect 
flags (TCBACTIV and TCBS3A). It uses a compare and 
swap (CS) instruction to do so. If successful and if the 
TCB is dispatchable (TCBFLGS4=0), IEAVETCL con¬ 
tinues processing at the next step. 

If the CS Instruction falls because the intersect flags are 
already set or if the CS instruction Is successful but the 
TCB is not dispatchable (TCBFLGS4*0), IEAVETCL 
cannot perform the resume function synchronously with¬ 
out further serialization. One exception to this is when 
the TCB is active on this processor. In this case, the task 
issued a RESUME for an RB in itself and serialization is 
not required unless the TCB is nondispatchable. (When 
the TCB is nondispatchable, serialization other than the 
intersect flags is required because the QUIESCE function 
might be preparing to swap out the target address space.) 

If either the intersect flags are already set or the TCB is 
nondispatchable, lEAVETCL's actions depend on the 
type of resume macro being processed and are described 
below. If I EAVETCL was able to set the intersect flags, 
it resets them to zero before taking the action described. 


• Conditional synchronous requests: IEAVETCL does IEAVETCL RCSC 

not complete the resume function. It deletes the 

FRR, resets the TCTL bit, restores the caller's system 
mask, and returns to the caller with a return code of 
4 to indicate that the resume function was not 
performed. 

• Unconditional synchronous requests: IEAVETCL IEAVETCL NOTCOND 

obtains further serialization. If the caller does not 

already hold the CML lock of the address space in 
which the input RB resides, I EAVETCL obtains 
it. If the caller holds any other CML lock, IEAVETCL 
issues ABEND X'070' with reason code 44. After 
obtaining the lock, IEAVETCL updates the resume 
registers and PSW, if requested by the caller to do so. 

IEAVETCL resets the specified RB's suspend count 
to zero, then tries again to obtain the intersect flags 
(TCBACTIV and TCBS3A). If successful, and if 
the CML lock was not already held at entry, 

IEAVETCL releases it. If the TCB is dispatchable 
(TCBFLGS4=0), IEAVETCL continues at step 5. 

Otherwise, processing continues at step 6. 


Extended Description Module Label 

4 (continued) 

• Conditional asynchronous requests: IEAVETCL IEAVETCL RSCA 

makes no further serialization attempts, but it tries 

to perform the resume function asynchronously. 

It issues a conditional request for an SRB. If one can 
be obtained from the supervisor's SRB pool using a 
GETSRB macro. IEAVETCL initializes and schedules 
the SRB to enter this module at entry point IEAVRSRB, 
where an unconditional synchronous RESUME macro 
is issued. After scheduling the SRB, IEAVETCL: 

— Turns off the TCTL super bit 

— Deletes the FRR 

— Sets a return code of 4 to indicate that an SRB was 
scheduled to perform the resume function asyn¬ 
chronously 

— Restores the caller's system mask 

— Returns to the caller 

If no SRBs are available, IEAVETCL cannot do the 
resume. It performs the cleanup functions described 
above, except that it sets a return code of 8 to indicate 
that the resume function was not completed. 

• Unconditional asynchronous requests: IEAVETCL IEAVETCL RSUA 
performs the same functions as it does for conditional 

asynchronous requests, except that it obtains the SRB 
unconditionally. 
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Diagram SUP-43. RESUME Service Routine (IEAVETCL) (Part 6 of 6) 


Extended Description Module Label 

5 IEAVETCL releases the RB from the suspend state MAINLINE 

by setting the RB suspend count (RBSCF) to zero. 

If the task does not require a local lock (TCBLLREQ-O), 
and if the RB released from the suspend state is the 
current RB (TCBRBP * the target RB address), the task 
Is now dispatchabie. IEAVETCL updates the resume 
registers and PSW if the caller requests. IEAVETCL 
adds one to the count of ready, unlocked TCBs 
(ASCBTCBS). 

g The caller can specify that, after completing the 
resume function, IEAVETCL either return to the 
caller or transfer control to the resumed TCB/RB. If 
IEAVETCL Is to return control to the caller, it: 

• Turns off the intersect flags 

• Turns off the TCTL super bit 

• Deletes the FRR 

• If the resumed RB is the current one, and if the task 
is dispatchabie, calls IEAVEMSO to notify other 
processors that work is ready (entry point IEAVEMS9) 

• Sets a return code of 0 

• Restores the caller's status 

• Branches to the caller 

If the caller requested that IEAVETCL exit to the NORTN 

resumed TCB/RB (the RETURN“NO option was speci¬ 
fied), IEAVETCL determines if the request is valid. The 
RETURN-NO option can be specified only by callers 
executing in SRB mode and in home mode. IEAVETCL 
terminates all other requestors with ABEND X'070' 
and reason code 12 (not in SRB mode) or 24 (not in 
home mode). If the PCLINK stack is not empty, it is purged. 

If the caller holds any locks, IEAVETCL abends the caller 
with reason code 28. If the request is vslid, control is 
passed to the TCTL service routine at label JOINTCT to 
attempt to give control to the resumed task. 


Extended Description Module Label 

Recovery Processing: 

When an error occurs while IEAVETCL is processing a IEAVETCR 

RESUME macro, RTM gives control to lEAVETCL's 

FRR (IEAVETCR). The FRR: 

o Records diagnostic information in the SDWA. 

• Establishes a nested FRR (entry point RSFRR2E 
within IEAVETCL) to protect this routine against 
errors in external routines (SDUMP, FREESRB) 
end errors in references to private storage. 

o Adds one to the count of ready TCBs (ASCBTCBS). 

If IEAVETCL had not yet decreased the count, this 
makes it high. 

• Issues an SDUMP of the resume TCB's address space. 

• If I EAVETCL had set the TCBACTIV and TCBS3A 
flags, resets them to zero. 

• If I EAVETCL had obtained an SRB, frees it. 

• Sets the TCTL super bit to zero. 

• Issues a SETRP to percolate the error and free the 
local lock (if IEAVETCL obtained it). 

If an error occurs while IEAVETCR is executing, RTM RSFRR2G 

gives control to entry point RSFRR2E. This FRR: 

• Records cfognostic information in the SDWA. 

• Sets the TCTL super bit to zero. 

• Issues a SETRP to percolate the error and free the, 
local lock (if IEAVETCL obtained it). 
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Diagram SUP-44. Validity Check Processing (IEAVEVAL) (Part 2 of 4): 


Extended Description 


Module Label Extended Description 


Module 


The validity check processing determines whether an 
address or address range belongs in the key of a specif¬ 
ied program. Supervisor service routines branch into 
validity check, giving as input the address (or range) of 
the area being checked. 

1 Validity check gives control back to the caller for IEAVEVAL IEA0VL01 

a starting address not on a fultword boundry. Valid¬ 
ity check passes a non-zero condition code (in the PSW) 

to the caller. 

2 Validity check obtains a protection key from one of IEAOVLOO 

three sources: 

t Passed as input by the caller 
or 

• From a TCB (TCBPKR) whose address is passed 
as input by the caller 

or 

• From the current TCB (via PSATOLD). 


3 Validity check uses the selected protect key to test 
the storage key of the specified page(s) via the TPROT 

instruction. If both storing and fetching is allowed on all 
pages within the selected range, validity check will return 
to the caller with a condition code of zero. If either 
storing or fetching is not allowed on any page, a non-zero 
return code is returned to the caller. 

4 If the TPROT instruction condition code indicates 
that a page or segment translation exception was en¬ 
countered, the following processing is done: 

• A recovery routine (FRR) is established to 
intercept any program checks 

• The protection key is switched to the selected 
input protection key 

• A compare and swap instruction is used to 
validate the storage area. 

The compare and swap (CS) instruction will do both a 
fetch and store into the specified address. If the check is 
successful, validity check loops to check the requested 
address range, if necessary. A program check error will 
result if the compare and swap instruction referred to an 
invalid address, resulting in the recovery routine gaining 
control via RTM. RTM gives control to the recovery routine 
at step 6, entry point VLCKFRR. 


Cm 

Cm 


Label 
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Diagram SUP-44. Validity Check Processing (IEAVEVAL) (Part 3 of 4) 


Input 


Process 


Output 
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Diagram SUP-44. Validity Check Processing (IEAVEVAL) (Part 4 of 4) 

Extended Description Module Label 

5 Validity check sets a condition code of 0 indicating 
a valid address. The protection key is changed back 

to 0, and control returns to the caller.' 

6 RTM gives control to validity check at entry point VLCKFRR 

VLCKFRR if a program check occurred. The 

validity check recovery routine determines whether an 
expected program check occurred—either a 0C4,0D0, or 
0D1. If one of the three expected error occurred, control 
goes to RTM to retry at entry point VALRETRY. Otherwise, 
control goes to RTM to give the caller's error routine control. 

7 RTM reenters validity chock at entry point VALRETRY. VALRETRY 

Here, validity check sets the condition code to a non-zero, 

and returns to the caller. 
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Diagram SUP-45. Supervisor Analysis Router Routine (IEAVESAR) (Part 1 of 6) 


From IEAVEREX and IEAVTRTM 


Input 
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| lccaacr! 


LCCA _ 

| LCCACPUS""| 


SCWA _ 

1 scwascwa"! 


SCWA 
SCWS ARP 
SCWELK 


PSA _ 

PSACSTK 
PSA _ 

FRRS _ 

FRRS 

FRRSENTR 

FRRSCURR 

FRRSPARM 


PSA _ 

PSASCWA 

PSALCCAW 
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| GSPALCcf] 


CVT _ 

CVTGSDA 

CVTLCCAT 

LOCAT 

| LOCATOOP"! 


ht 


0 2 

0 3 


0 4 


0 5 


Verify system fields. 


Is ACR active on this 
processor? 

If yes 

If no, continue 


Verify pointer to the 
SDWA. 


Is this a recursive entry, 
or IEAVELKR was 
called by RTM and lock 
repair was not complete. 

If yes 

If no, continue 


Set up FRR. 



Output 



PSA CVT 


FLCCVT 


CVTGSDA 

PSALCCAV 


CVTLCCAT 

LCCAT 

LCCA 

| LCCAT00P 


LCCALCCA | 



Return to 
caller 



PSA _ 

PSALCCAV 

PSASCWA 


WSAVT 

| scwascwa"| 


LCCA _ 

| LCCACPUS~| 

SCWA _ 

| wsacscwa] 
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Diagram SUP-45. Supervisor Analysis Router Routine (IEAVESAR) (Part 2 of 6) 

Extended Description Module Label 

IEAVESAR refreshes critical control block pointers and 
calls component analysis routines that continue to 
refresh/repair process. 

1 IEAVESAR verifies system fields that are required to 
continue processing in this module. Refreshes the 

CVT pointer. IEAVESAR repairs the PSALCCAV and 
verifies the GSDA, LCCT, or the PSALCCAV. 

If the PSALCCAV pointer and the LCCATOOP entry for 
this processor both fail LRA checks, then IEAVESAR sets 
the processor in an X'083 f disabled wait. 

Otherwise, if needed, IEAVESAR refreshes the PCCATOCP, 
the PSALCCAV, and LCCA ID, then returns to the sub- 
routine caller. 

2 IEAVESAR checks the status of ACR. If ACR is 
active on this processor, IEAVESAR returns to the 

caller. Otherwise, continues at the next step. 

3 I EAVESAR verifies the PSASCWA. 

• If both the PSASCWA and the LCCAPUS fail LRA 
checks, then sets the processor in a X*083' disabled wait. 

• If both the PSASCWA and the WSACSCWA fail LRA 
checks, then sets the processor in a X'083' disabled wait. 

4 If this is a recursive entry into IEAVESAR, or 
IEAVELKR was called directly by RTM, and lock 

repair processing returns to the caller. 

5 IEAVESAR sets up a functional recovery routine 
(FRR). 
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Diagram SUP-45. Supervisor Analysis Router Routine (IEAVESAR) (Part 3 of 6) 
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Pseudo DSWA 
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6 Turn on the super bit. 


7 Initialize the recursive 
control flag in the 
SCWA. 


8 Identify the caller in 
the FRR. 


9 Initialize the pseudo 
SDWA. 


10 Log error data. 
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Output 
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Diagram SUP-45. Supervisor Analysis Router Routine (IEAVESAR) (Part 4 of 6) 

Extended Description Module Label 

g IEAVESAR turns on the super bit. 

7 IEAVESAR initializes a recursive control flag in the 
SCWA. 

8 IEAVESAR identifies the caller in the FRR parameter 
area. 

9 IEAVESAR initializes the pseudo SDWA in the 
processor-related work area. 

10 If error data was collected prior to the initialization of 
the pseudo SDWA, IEAVESAR moves error data, with 
control block name and field name, the VRA of the pseudo 
SDWA. 
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Output 
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Diagram SUP-45. Supervisor Analysis Router Routine (IEAVESAR) (Part 6 of 6) 

Extended Description Module Label 

11 IEAVESAR initializes the necessary parameters and IEAVELCR 

registers, calls the repair/analysis routines. IEAVESAR IEAVELKR 

calls the low storage refresh routine, the spin lock repair IEAVEVRR 
lock routine, and the ASVT and AFT verification/ 
reconstruction routine. 

12 If error data exists in the pseudo SDWA, then 
IEAVESAR: 

• Completes the necessary SDWA initialization. 

• Sets the ABEN D and reason codes. 

- If the caller is IEAVEREX then the ABEND code is 
X*071' and the reason code is 4. 

— If the caller is IEAVTRTM then the existing ABEND 
and reason codes are propagated. 

• Records the pseudo SDWA in SYS1 .LOGREC using the 
RECORD function. 

13 IEAVESAR performs necessary clean up prior to exit¬ 
ing. It resets the mainline recursion control, resets 

the IEAVESAR super bit,and deletes recovery. IEAVESAR 
then returns to the caller. 

Recovery Processing 

The IEAVESAR recovery routine (ESARFRR) performs 
the following functions: 

• Resets the IEAVESAR super bit. 

• Resets the recursion control (SCWSARP) to allow 
IEAVESAR to process the next call. 

• Indicates in the SDWA, the module in control at the 
time of the error. 

• Indicates in the VRA that an unexpected error occurred. 

• Moves the 6-word FRR parameter area to the VRA. 

• Indicates percolation to RTM via SETRP. 

• Returns to RTM. 


"Restricted Materials of IBM" 
Licensed Materials ~ Property of IBM 



SUP-346 MVS/XA SLL» Supervisor Control LY28-1765-0 (c) Copyright IBM Corp. 1987 


Diagram SUP-46. Address Space Verification Processing (IEAVEVRR) (Part 1 of 4) 

From IEAVESAR 

Input | Process 


Register 13 


save area 

U_ 

Register 1 


Parameter 

List 


RTM-Supplied 
error data 


Master's ASCB 


ASCBASTE 


H 


ASTESTA 


PSAVT 


SVT 


SVTAFTV 


AFT contains 
virtual addresses 


Register 0 


entry code 


Register 1 

/ _ ... 


l Parameter List 

MSTRASCB 


Address Space Verification 
Routine (IEAVEVRR) 


1 If necessary, refresh the 
master memory's seg¬ 
ment table origin regis¬ 
ter value ('PSASTOR') 
field. 

• Entry code indicates 
restart. 


2 If necessary, rebuild the 
address space first table 
(AFT). 

• Dispatcher and CMS 
locks are not held. 


Output 



Return to 
caller 


PSATOR 


Master address space 
segment table 



SVTAFTR 


AFT containing 
real addresses 
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Diagram SUP-46. Address Space Verification Processing (IEAVEVRR) (Part 2 of 4) 

Extended Description Module Label 

Address space verification processing routine. 

1 If necessary, refreshes the master memory's segment 
table origin register value CPSASTOR') field from the 

master address space second table entry (ASTE). 

2 IEAVEVRR rebuilds the real AFT from the virtual 
AFT if the following is true: 

— the entry is from RTM via IEAVESAR, and 

— the error was a special operation exception, and 

— an address first table (AFT) exception, or an address 
second table exception. 
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Diagram SUP-46. Address Space Verification Processing (IEAVEVRR) (Port 3 of 4) 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 
























LY28-1765-0 (c) Copyright IBM Corp. 1987 Method of Operation SUP-349 


Diagram SUP-46. Address Space Verification Processing (IEAVEVRR) (Part 4 of 4) 

Extended Description Module Label 

3 If entry is from RTM via IEAVESAR and the CMS and 
DISPATCHER locks are held, IEAVEVRR searches 

the address space vector table (ASVT) for invalid entires. 

• Unassigned entries should contain an address within the 
table. 

• Unassigned entries should contain the virtual address of 
a valid ASCB. 

If no invalid entries are found, IEAVEVRR returns to its 
caller. 

4 IEAVEVRR calls the system queue verifier 
IEAVEQV3) to chain through the address space 

created queue (ASCR). IEAVEVRR reconstructs all ASVT 
entries that are assigned to ASCBs. 

5 Working from the bottom of the ASVT to the top, 
available entries are chained into three queues: 

• Available entries reserved for STARTed/SASI address 
spaces with the field ASVTRSHD as queue header. 

• Available entries for max users, less the number of 
active address spaces, using the field ASVTFRST 
as queue header. 

• All remaining entries used for replacements for 
non-reusable AS IDs with the field ASVTDSHD 
as queue header. 

These queues are embedded within the ASVT. The 
queue header points to the first available ASVTENTY 
field, and so on. The last available entry contains zeros. 


IEAVEVRR returns to the caller. 
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Diagram SUP-47. External Call Second Level Interruption Handler (IEAVEXS) (Part 1 of 4) 


Input 


From the external 
first level interruption 
handler (IEAVEEXT) 
to process an external 
call interrupt 


PSA 


PSAPCCAV 


iPCCA 


PCCARBP 


Process 


rn 


*| Obtain the pointer 
to the PCCA. 

2 Check the PCCARPB 
bits to determine 
which function was 
requested. 

If all functions 
are complete, go to 
step 6. 

3 Establish recovery 
environment around 
the requested function. 

4 Perform the service requested by 
the RPSGNL macro: 

• For MEMSWT. 


• For RQCHECK. 


• For GTF. 

• For MODE. 

• For SWITCH. 

5 Delete the recovery 
environment and go 
to step 2. 

6 Return to the caller. 


Output 


PSA 


a 


Entry point 
IEAVEMS3 in 
module IEAVEMSO 


Memory switch 


Entry point 
IEAVRQCK in 
module IEAVRTIO 


RQCHECK routine 


Entry point 
AHLSTCLS in 
module AHLMCIH 
GTF 


Entry point 
IGFPEXI2 in 
module IGFPEXIT 


MODE routine 



To the address set up 
by the external first 
level interruption 
handler (IEAVEEXT) 


PSAPCCA 




PCCA 


PCCARBP 
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Diagram SUP-47. External Call Second Level Interruption Handler (IEAVEXS) (Part 2 of 4) 

Extended Description Module Label Extended Description Module 


When an external call interruption occurs, the external 
FLIH (IEAVEEXT) gives control to the external call 
second level interrupt handler (SLIH). The SLIH routes 
control to any of four system routines. The system 
routine to receive control is determined by the issuer of 
the RPSGNL macro (remote pendable signal routine 
IEAVERP). The option specified on the macro corre¬ 
sponds to the following action: 

• MEMSWT - memory switch routine (IEAVEMS3) 

• RQCHECK - TOD clock synchronization (I EAVRQCK) 

• GTF - GTF function (AHLSTCLS) 

• MODE - Mode function (IGFPEXI2) 

• SWITCH - No system routine is given control; this 

option is used to preempt work currently 
on specified processor. 

Control returns to the external call SLIH; the SLIH returns 
control to the point established by the external FLIH. 


2 The PCCA contains an indicator in the external call 
SIGP buffer (PCCARPB) that specifies the service 

requested in the RPSGNL function. The external call 
SLIH checks the PCCARPB field for each possible con¬ 
dition to determine which services are to receive control, 
In each case, the external SLIH: 

• Determines the actions requested in the RPSGNL 
function. 

e Turns off the Indicator in the PCCARPB. 

3 The external call SLIH establishes the recovery en¬ 
vironment to handle errors in the receiving routine. 

4 The external call SLI H branches to the appropriate 
service routine except in the case of the SWITCH 

option. Since no further service routine processing is 
required for the SWITCH option the SLIH will return 
to the dispatcher if in task mode. The dispatcher will 
save the status of the interrupted task thus completing 
the function requested by the SWITCH option. If not 
in task mode, the SLIH will return to the interrupted 
routine. 


« The external call SLIH locates the PCCA (physical IEAVEXS IEAVEXS 

1 control communications area) of the executing 5 The SLIH deletes the recovery environment, 

processor by referring to the PSA (prefixed storage area). 

6 Control returns to the address set up by the external 
FLIH. The return address is either the dispatcher 
or an entry point in the external FLIH, depending on the 
system mode at the time the Interruption occurred. 


Label 


RETRYPT 
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Diagram SUP-47. External Call Second Level Interruption Handler (IEAVEXS) (Part 3 of 4) 


From 
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Diagram SUP-47. External Call Second Level Interruption Handler (IEAVEXS) (Part 4 of 4) 
Extended Description Module Label 

7 Indicates error information in the SDWA and VRA 
areas. 

8 Depending on the reason entered, uses the SETRP 
macro to indicate to RTM to either retry to the 

mainline or percolate. 
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Diagram SUP-48. Lock Freeing Routine (IEAVFRLK) (Part 1 of 2) 
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Diagram SUP-48. Lode Freeing Routine (IEAVFRLK) (Part 2 of 2) 


Extended Description Module Label 

IEAVFRLK is called by RTM to clear the global and local 
intersects, and to free all locks held by the current process. 

1 IEAVFRLK disables for external and I/O interrupts. 

It then saves the caller's registers 1-14 in the SCWA. 

2 If the dispatcher lock is held, the global intersect is 
cleared by setting the SVTDSREQ word to ail zeros. 

3 If the local lock is held, the local intersect is cleared 
by setting the ASCBSRQ word in home's ASCB to 

all zeros. 

4 If the caller is in task mode and the status stop 
pending flag (ASCBSSPC) is on and the DAT error 

flag (ASCBDTER) is off, then secondary addressability 
is established to the home address space. If the status 
stop pending flag (TCBSSPC) is on for the current task 
then the status routine is called to complete the pending 
status request. The caller's secondary addressability is 
restored. 

5 The caller's registers 1-14 are restored from the SCWA 

and external and I/O interrupts are enabled. 
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Diagram SUP-49. CML Lock Cleanup for Current DAT ERROR Process (IEAVLKRM) (Part 1 of 2) 


Input 


Called by RTM if a DAT 
error process holds a CMLJock 


Register 1 



) ^ PSW 



Entry point IEAVCCML 
1 Obtain an SSRB/XSB. 


2 Preserve the status of 
the current process in 
the SSRB/XSB. 


3 Call RTM, type=RMGRCML 
to set up the SSRB to ^ 
abend. ^1 


4 Change CML lock 
ownership from the DAT 
error address space to 
master. 

5 Schedule the SSRB. 


Output 
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SRBLLHLD 
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Diagram SUP-49. CML Lock Cleanup for Current DAT ERROR Process 

Extended Description Module Label 

If a process has suffered a DAT error while holding the 
CML lock of another address space. RTM calls IEAVLKRM 
at entry point IEAVCCML 

1 Obtain an SSRB/XSB. 

2 ■ EAVLKRM initializes the SSRB/XSB to represent the 
DAT error process with the exception that it is to run 

in the master's address space. The following fields are 
initialized in the new SSRB: 

• SRBPASID is set to one. 

• SRBASCB is set to point to the master's ASCB. 

• SRBLLHLD is set to indicate a local lock is held. 

• SRBHLHI is set to indicate a local lock is held. 

• SSRBCPUT and SSRBTIME fields are both set to 
208-day time value. 

The following DAT error process status is saved in the 
SSRB or XSB: 

• PSW at the time of error 

• GPRsO-15 

• Control registers 3 and 4 

• The contents of the normal FRR stack 

• XSBX LAS is set to point to the locked ASCB. 

The PCLINK stack header (RSASTKE) is set to zero to pre¬ 
vent any accidental reference to the DAT address space 
private storage via the stack chain. 


(IEAVLKRM) (Part 2 of 2) 

Extended Description Module 

3 IEAVLKRM calls RTM, type=RMGRCML to set 
up the SSRB to abend. 

4 The process of changing the CML lock ownership 
from the DAT error address space to appear to be 

owned by a suspended unit of work in the master's 
address space consists of the following steps: 

• PSA LOCAL is set to zero. 

• PSALCLLI {local lock held flag in the CLHS) 
is turned off. 

• In the locked address space: 

- ASCB LOCK is set to '4FFFFFFF' 

{ready-to-run ID) 

— ASCB LOCI is set to point to the master's ASCB 
— ASCBCMLH is set to point to the new SSRB 

• In the DAT error address space: 

— The count of CML locks held (ASCBCMLC) is 
decreased by one. 

• In the master's address space: 

— The suspended SRB count (ASCBSCNT) is 
increased by one. 

— The count of CML locks held (ASCBMLC) is 
increased by one. 

• XSBXMCRS in the new XSB is set equal to the 
master's control register 3 and 4. 

5 When this process is dispatched, it will abend with 
an X'064' completion code and RTM will attempt 

to give control to any FRRs on the normal stack at the 
time of the DAT error so that the FRRs can release 
resources, including the CML lock. 


Label 
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Diagram SUP-50. CML and LOCAL Lock Resource Managers (IEAVLKRM and IEAVELRM) (Part 1 of 6) 
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Module 


Label 


Diagram SUP-50. CML and LOCAL Lock Resource Managers (IEAVLKRM and IEAVELRM) (Part 2 of 6) 

Extended Description Module Label Extended Description 


This diagram describes both the CML resource manager 
(IEAVLKRM) and the LOCAL lock resource manager 
(entry point IEAVELRM within IEAVLKRM). IEAVLKRM 
is described In steps 1-4, IEAVELRM in step 5. 

CML Resource Manager (IEAVLKRM) Processing 

RTM gives control to IEAVLKRM early in address space 
termination processing. IEAVLKRM ensures that any 
CML locks owned by the terminating address space 
are later released. Also, if the failing address space's 
CML lock is held, IEAVLKRM ensures that the unit of 
work holding the lock is abended. At entry, register 1 
contains the address of a pointer to the resource 
manager parameter list (RMPL). 

1 IEAVLKRM obtains the dispatcher lock to 
serialize the ASVT scan described In step 3. It issues 

a SETFRR macro to establish LKRMFRR (an entry 
point within IEAVLKRM) as its recovery routine. (See 
"Recovery Processing" for a description of LKRMFRR.) 

2 If no address space owns the failing address space's 
local lock as a CML lock, IEAVLKRM continues 

at the next step. If another address space does own the 
failing address space's CML lock, IEAVLKRM sets the 
non-reusability flag (ASCBXMET) in the failing address 
space's ASCB. This prevents any suspended SRBs from 
being rescheduled to the wrong address space by pre¬ 
venting the reuse of this ASID. 

If an SSRB holds the failing address space's CML lock, 
no other processing is required. When the SSRB is made 
dispatchable and the dispatcher finds that the CML-locked 
address space cannot be accessed, it terminates the unit of 
work represented by the SSRB. 


If a task holds the CML lock, IEAVLKRM prepares the 
task to be dispatched. It: 

• Checks for a DAT error in the terminating address 
space. If there is an error, the task holding the CML 
lock is reset by calling the status subroutine. 

• Copies the registers and PSW from the task's IHSA into 
the TCB/RB. 

• Copies the FRR stack from the IHSA into the TCB's 
NSSA. 

• Sets the TCBCMLF flag, which indicates to the dispatcher 
that the CML resource manager has put the appropriate 
status into the TCB/RB and NSSA. (The dispatcher does 
not redispatch the task until this flag Is set.) 

• If status pending is on for this task (TCBSSPC ° ON), 
resets the task by calling the status subroutine at entry 
point IGC07904 in module IEAVSETS. 

When the dispatcher attempts to dispatch the task and finds 
that the task cannot establish addressability to the CML- 
locked address space, it abends the task. RTM then gets 
control to process the FRR stack saved In the NSSA. This 
permits the recovery routines to clean up any resources 
serialized by the lock and to release the lock. 
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Diagram SUP-50. CMLand LOCAL Lock Resqurce Managers (IEAVELKRM and LEAVELRM) (Part 3 of 6) 
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Diagram SUP-50. CML and LOCAL Lock Resource Managers (IEAVLKRM and IEAVELRM) (Part 4 of 6) 


Extended Description 

Moduto LaM 

Extended Description 

Module Label 

3 If the failing address space owns any CML locks Ithe 
ASCBCMLC field is greater then zero), IEAVLKRM 
scans the ASVT for the address spaces whose CML locks 

IEAVLKRM LKRMCMLS 

4 IEAVLKRM releases the dispatcher lock, 
deletes the FRR, and returns to RTM. 

IEAVLKRM LKRMXIT 


it holds (the address spaces whose ASCBLOCI values 

match the address of the failing address space's ASCB). 

For each such address space found, IEAVLKRM: 

• Issues a GETSSRB macro to obtain an SSRB. 

• Initializes the SSRB to run in the master scheduler's 
address space by setting the SRBPASID and SRBASCB 
fields to reflect the master scheduler's address space. 

• Copies the processor timer values and PCLINK stack 
header into the new SSRB/XSB. IEAVLKRM takes 
these values from either the old SSRB/XSB or the 
owning task's IHSA. 

e Issues a CALLRTM macro to have RTM copy the lock 
holder's recovery information into the SSRB, and to 
set the SSRB to abend when dispatched. This allows 
the appropriate FRRs to get control after the SSRB 
abends. 

e Puts the master scheduler's control register values into 
the new SSRB's control register fields. 

a Sets the SRBLLHLD and SRBHLHI fields to make it 
appear as though the SSRB holds the CML lock. 

• Puts the ASCB address of the master scheduler's ASCB 
into the ASCBLOCI field, and indicates that an SSRB 
holds the CML lock. 

a Adds one to the master scheduler's count of suspended 
SRBs (ASC8SRBS). 

a Adds one to the master scheduler's count of CML locks 
held (ASCBCMLC). 

g Schedules the SSRB to execute in the master scheduler's 
address space. When dispatched, the SSRB abends. RTM 
gets control to process the FRR stack associated with the 
CML lock. These FRR routines clean up any resources 
serialized by the lock and release the lock. 
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Diagram SUP-50. CML and LOCAL Lock Resource Managers (IEAVLKRM and IEAVELRM) (Part 5 of 6) 



Output 
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Diagram SUP-50. CML and LOCAL Lock Resource Managers (IEAVLKRM and IEAVELRM) (Part 6 of 6) 

Exttndid Description Modulo Label 

LOCAL Lock Resource Mana ger (IEAVELRM) Processing 

5 RTM gives control to IEAVELRM near the end of address 
space termination processing. IEAVELRM cleans up the 
terminating address space's local lock suspend queue. It 
puts the appropriate information in the queued SRB/SSRB's 
to make them appear valid and reschedules them. This 
causes the dispatcher to put the SRB/SSRBs back on the 
local or global service priority list (SPL). However, because 
the failing address space's ASCBFAl L flag is on, the dis¬ 
patcher cannot allow the SRB/SSRBs to run. They remain 
on the dispatching queue until PURGEDQ finds them and 
calls their re sp ec ti ve resource termination managers. 

IEAVELRM then returns to RTM. 

Recovery Pr o ces sing 

When an error occurs while IEAVLKRM is executing, RTM 
gives control to LKRMFRR. LKRMFRR requests that RTM 
free the diqjatcher lock, records diagnostic information in 
the SDWA and, if necessary, frees the SSRB that IEAVLKRM 
obtained. LKRMFRR then returns to RTM. 
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Diagram SUP-51. DATOFF Macro Service Routine (IEAVMVCO) (Parti of 4) 


Input 


From DATOFF 
macro with 
INDMVCLO index 


Process 


Registers 



Registers 



From DATOFF 
macro with 
INDXCO index 





Entry point: IEAVMVCO 

1 Move data from source to 
target using MVCL instruction. 




Entry point: IEAVXC0 

2 Exclusive OR target 
area with source area. 


Return to 
caller 


Exclusive OR 


Return to 
caller 


Output 


Target Area 


Register 15 

l—r 


Target Area 


Register 15 

I 0 
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Diagram SUP-51. DATOFF Macro Service Routine (IEAVMVCO) (Part 2 of 4) 


Extended Description Module 

IEAVMVCO contains several generalized IBM-supplied 
DATOFF routines. Access to the routines is through 
the DATOFF macro. 

DATOFF Index INDMVCLO: 

1 Moves the data from the source location to the IEAVMVCO 

target location specified by the caller using a 

MVCL instruction. Sets a zero return code. 

DATOFF Index INDXCO: 

2 Exclusive ORs the data in the target location with I EAVMVCO 
the source area data specified by the caller using 

an XC instruction. Sets a zero return code. 


Label 


IEAVMVCO 


IEAVXCO 
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Diagram SUP-51. DATOFF Macro Service Routine (IEAVMVCO) (Part 3 of 4) 


















LY28-1765-0 (c) Copyright IBM Corp. 1987 Method of Operation SUP-367 


Diagram SUP-51. DATOFF Macro Service Routine (IEAVMVCO) (Part 4 of 4> 

Extended Description Module Label 

DATOFF Index INDMVCLK 

3 Switches to the PSW protect key specif ted by the IEAVMVCO IEAVMVKY 

caller. Moves the data from the source location 

to the target location specified by the caller using a 
MVCL instruction. Returns to protect key zero and 
sets a zero return code. 

DATOFF Index is Invalid 

4 Abends the caller with a X'OFF’ completion code. 

DATOFF detected an invalid index passed to the DATOFF IEAVMVCO IEAVDFTA 

linkage routine. 
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Diagram SUP-52. Processor Controller Damage Monitor Routine (IEAVSPDM) (Part 2 of 6) 


Extended Description Module Label 

IEAVSPDM Is attached by the master scheduler 
(IEEMB860) during system initialization and waits 
on an ECB that will be posted when a processor 
controller machine check occurs. If the ECB is 
posted, IEAVSPDM notifies all listening subsystems 
that the processor controller is damaged via the 
subsystem interface. IEAVSPDM also issues a 
message to notify the operator that the processor 
controller is damaged. 

1 If there is no usable maintenance service and 

support facility (MSSF) hardware present or IEAVSPDM IEAVSPDM 

if the code is executing on a VM configuration (field 
CVTMSFCB is zero), return to the master scheduler. 

Before accessing the CVT, force the reset of cache 
lines. This prevents this module from bringing down 
the system if there were cache interference and MSSF 
was not working at this point. 

2 Establish SPDMRECV as the error recovery routine 
by issuing the ESTAE macro. If ESTAE is not 

successful, abend the caller with abend code X'050'. 
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Diagram SUP-52. Processor Controller Damage Monitor Routine (IEAVSPDM) (Part 3 of 6) 
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Diagram SUP-52. Processor Controller Damage Monitor Routine (IEA VSPDM) (Part 4 of 6) 

Extended Descriptor 

3 Obtain fixed LSQA storage {subpool 255) for the 
machine check handler's MSSF ECB and place its 

address in the CVT. Before accessing the CVT, force 
the reset of cache lines. This prevents this module from 
bringing down the system if there were cache interference 
and MSSF was not working at this point. 

4 Set a flag to indicate that MSSF is not damaged. 

5 Clear the machine check handler's MSSF ECB and 
clear the dummy ECB to be used for an indefinite 

wait after the processor controller has been damaged. 

Initialize the subsystem output block (SSOB) and sub¬ 
system initialization block (SSIB). 
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Diagram SUP-52. Processor Controller Damage Monitor Routine (IEAVSPDM) (Fart 5 of 6) 


Input 


Process 



6 Wait to be posted. 

7 When posted: 


a) Use the SSI to notify 
the system of the 
damage to the processor 
controller. 

b) Notify the operator 
of the processor 
damage. 

c) Enter an indefinite 
wait state on an ECB 
that will never be 
posted. 


Output 











LY28-1765-0 (c) Copyright IBM Corp. 1987 Method of Operation SUP-373 


Diagram SUP-52. Processor Controller Damage Monitor Routine (1EA VSPDM) (Part 6 of d) 

Extended Description Module Label 

6 Issue WAIT macro to Malt until the ECO it potted, 
either by the machine check handler or alternate CPU 

recovery. 

7 When the ECB h potted, do the fotlowing: 

a) Notify listening subsystems of the damage to the MSSFDEAD 

processor controller vie the subsystem interface. 

bl I Issue message IEA470W to notify the operator of 
the damage to the processor controller. 

c) Enter an indefinite wait state on the dummy ECB 
that will never be posted. An Indefinite wait Is 
entered rather then returning to the caller to 
preserve the MSSF ECB in case any attempt Is 
made to access It again. 
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ZEAVCKRS - MODULE DESCRIPTION 

DESCRIPTIVE NAMES Checkpoint/Restart Exit Routine Router 
FUNCTION: 

Checkpoint/Restart passes control to this Supervisor Control 
module (IEAVCKRS) (via the entry point address in CVTCSPIE) 
which is responsible for calling the appropriate exit routines 
to perform Checkpoint/Restart processing. 

IEAVCKRS is called by Checkpoint/Restart three times (twice 
for the Checkpoint and once for the Restart) to invoke the 
appropriate exit routines. Each time* register one will point 
to a queue of at least one SSCR (Subsystem Checkpoint Record). 

The SSCRCKRS and SSCRBKC bits within the first SSCR will be 
set as follows: 

- First call - SSCRCKRS = 1 SSCRBKC = 1 

- Second call - SSCRCKRS = 1 SSCRBKC = 0 

- Third call - SSCRCKRS = 0 SSCRBKC is unused 

The first call is a request to return the number of SSCRs 

needed to checkpoint the task. The Exit Routines are 
responsible for returning the number of SSCRs they require. 

On the second call* Checkpoint/Restart passes a queue of the 
requested SSCRs to IEAVCKRS. The Exit Routines are responsible 
for storing the appropriate task related status in the SSCRs. 

On the third call* Checkpoint/Restart passes the same queue of 
SSCRs to IEAVCKRS. The exit routines are responsible for 
restoring the task's status from the SSCRs. 

ENTRY POINT: IEAVCKRS 

PURPOSE: 'Refer to the module function topic; 

LINKAGE: Branch entered via CVTCSPIE 

CALLERS: Checkpoint/Restart 

INPUT: 

- A queue of one or more SSCRs pointed to by register 

one upon entry 

- The SSCRCKRS and SSCRBKC bits in the first SSCR on 

the queue set to indicate the function to be performed 


OUTPUT: 

- All exit routines called to perform the appropriate 

Checkpoint/Restart processing based on the values 
of the SSCRCKRS and SSCRBKC bits 

- SSCRBLKC set to the total number of SSCRs requested by 

the exit routines plus one for the SYSTEM SSCR (SSCRBLKC 
is set only when the SSCRCKRS and SSCRBKC bits are one) 

EXIT NORMAL: To Checkpoint/Restart with return code in register IS 

EXIT ERROR: To Checkpoint/Restart with return code in register IS 

EXTERNAL REFERENCES: 

ROUTINES: 

IEAVCRVF - (Vector Checkpoint/Restart Exit routine) 

IEAVSPI - (ESPIE Checkpoint/Restart Exit routine) 

DATA AREAS: 

The first SSCR on the queue during Checkpoint processing 
and Common IEAVCKRS processing will contain SSCR count 
information related to each of the called oxit routines. 

This SSCR is refered to as the System SSCR. 
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SUP-53. Checkpoint/Restart Exit Routine Router (IEAVCKRS) 
IEAVCKRS - MODULE DESCRIPTION (Continued) 

CONTROL BLOCKS: 

SSCR (Subsystem Checkpoint Record) - (r>w) 

r = Read 
w = Write 

TABLES* EXITTABLE - The internal exit routine name and ID table 
SERIALIZATION: No special serialization is required. 
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SUP-53. Checkpoint/Restart Exit Routine Router (IEAVCKRS) 

IEAVCKRS - MODULE OPERATION 

IEAVCKRS will LOAD each exit routine module and save the 
address for later use. The names of the exit routines will be 
obtained from a static table resident in IEAVCKRS. Associated 
with each exit routine will be a one byte unique exit routine 
10. This ID will also reside in the table. Any future exit 
routines will be added to the end of the table. 

The SSCRCKRS bit within the first input SSCR will be examined. 

If it is one, the SSCRBKC bit will be examined. If it is one, 

Checkpoint/Restart has requested a count of SSCRs to be 
returned. "Checkpoint Count SSCR Processing" will be done. If 
the SSCRBKC bit is zero* "Checkpoint Processing" will be done. 

If the SSCRCKRS bit is zero, a restart operation is taking 
place. "Common IEAVCKRS processing" will be performed. 


All exit routines previously LOAOed will then be DELETEd. 
Control will pass back to the caller with the appropriate 
return code. The return code will be in the following 
format. 


'OOOOxxyy* Where xx is a one byte exit routine 
ID of the exit routine which passed 
a non-zero return code 
and 

yy is the return code passed back from 
the exit routine whose ID is xx 

If all exit routines completed successfully, the return code 
will be zero. 


"CHECKPOINT COUNT SSCR PROCESSING" 

IEAVCKRS will keep a count of the total number of SSCR blocks 
requested by the exit routines. One additional SSCR will be 
needed to contain IEAVCKRS control information. This SSCR will 
be referred to as the system SSCR. 

The count of total SSCRs will be initialized to one (for the 
system SSCR). Then, for every exit routine in the table, the 
following will be done. The SSCRBLKC field in the input SSCR 
will be zeroed. Then the exit routine will be called. The 
address of the input SSCR will be passed in register one. Upon 

return, if the SSCRBLKC is not less than zero, it will be 

addad to the count of total SSCRs. If the SSCRBLKC field is 
less than zero, IEAVCKRS will return to Checkpoint/Restart 
with the appropriate return code. 

After all exit routines have been called, thr cnimt of SSCRs 
will be compared lo or.a. If equal, Cncrsa cf the exits require 
SSCRs) the SSCRBLKC field will be set to zero. Checkpoint will 

not invoke IEAVCKRS again if no SSCRs are requested since none 

of the exit routines have data to checkpoint. If the count of 
SSCRs is not equal to one, SSCRBLKC will be set to the count 
of SSCRs. 


"CHECKPOINT PROCESSING" 

Because Checkpoint/Restart provides IEAVCKRS no usable data 
area across the first and second calls to IEAVCKRS (between 
"Checkpoint Count SSCR Processing' 1 and "Checkpoint 
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SUP-53. Checkpoint/Restart Exit Routine Router (IEAVCKRS) 
ZEAVCKRS - MODULE OPERATION (Continued) 


Processing”), the count of SSCRs needed by each exit routine 
is not saved from the first call. Register one points to the 
queue of SSCRs whose first element is the system SSCR. 
"Checkpoint Count SSCR Processing" will be repeated with one 
exception. Instead of totaling the number of SSCR blocks, the 
number of SSCRs requested by each exit routine will be saved 
in the system SSCR. This will be accomplished in the following 
way. 

The SSCRCKRS and SSCRBKC bits of a 20 byte dummy SSCR will be 
set to one. Then for each exit routine in the table , SSCRBLKC 
in the dummy SSCR will be zeroed. The exit routine will then 
be called. Register one will contain the address of the dummy 
SSCR. Upon return 9 the dummy SSCR3LKC field will be saved in 
the system SSCR in a location associated with the exit routine 
invoked. 

The number of SSCRs on the queue will then be compared to the 
total number of SSCRs recorded in the system SSCR. If the 
counts are not equal, at least one of the called exit routines 
has requested more or less SSCRs than it requested on the 
first call. In this case* IEAVCKRS will return to 
Checkpoint/Restart with the indicative return code. 

After all exit SSCR counts have been recorded in the system 
SSCR, "Common IEAVCKRS Processing" will be performed. 


"COMMON IEAVCKRS PROCESSING" 

For the purpose of discussion, let each SSCR in the queue of 
SSCRs be subscripted from 1 to N. Furtner let SSCR(l) be the 
system SSCR. 

An SSCR-INDEX will be set to 2 (pointing to the first 
non-system SSCR). Then for each exit routine in the table that 
requested more than 0 SSCRs, the following will be done. 

The forward pointer in the last SSCR belonging to the current 
exit routine (SSCRFCHN) will be saved. Then the SSCRFCHN field 
will be zeroed. This will prevent the called exit routine 
from accessing SSCR blocks it does not own. The SSCRFLG1 
field from the system SSCR (SSCR(l)l will be copied to the 
SSCRFLG1 field in SSCR(SSCR-INDEX). The SSCRFLG1 field 
contains the SSCRCKRS and SSCRBKC bits which communicate to 
the exit routine whether the checkpoint or restart action is 
to be taken. The exit will then be called. Register one will 
contain the address of SSCR(SSCR-INDEX). Upon return, the 
saved SSCRFCHN field will be restored to the forward pointer 
of the last SSCR belonging to the exit routine just processed. 
The SSCR-INDEX will be advanced to the first SSCR belonging to 
the next exit routine to be called. 

RECOVERY OPERATION: 

IEAVCKRS runs under the caller's recovery. 

Note - Each exit routine is responsible for its own recovery. 
Checkpoint/Restart has recovery set up before the call to 
IEAVCKRS. Any undetected error in an exit routine will 
percolate to Checkpoint/Restart. 
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SUP-53. Checkpoint/Restart Exit Routine Router (IEAVCKRS) 

IEAVCKRS - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEAVCKRS 

MESSAGES: None 

ABEND CODES: None 

WAIT STATE CODES: None 

RETURN CODES: 

EXIT NORMAL: 

Return codes are presented to the caller in register 15. 

Return code Explanation 

X*00000000 1 All exit routines returned a 
zero return code. 

EXIT ERROR: 

Return codes are presented to the caller in register 15. 
Return code Explanation 

X'OOOOxxyy 1 The exit routine whose ID is xx 

passed back the non-zero yy return 
code. 


Specific return codes for error conditions detected 
in the IEAVCKRS module are as follows: 


Return code Explanation 


X'00000108* IEAVCKRS has detected that the 

number of SSCRs requested by the 
exit routines from the first 
Checkpoint/Restart invocation 
is not equal to the number of 
of SSCRs requested by the exit 
routines on the second 
Checkpoint/Restart invocation 


X*OOOOxxFF' IEAVCKRS has detected that the 
the exit routine whose 10 is xx 
has requested a negative number 
of SSCRs 


REGISTER CONTENTS ON ENTRY: 

0 - Irrelevant 
1 - Address of SSCR Queue 
2-12 - Irrelevant 

13 - Address of 18 Word Save Area 

14 - Return Address 

15 - Entry Point Address 


REGISTER CONTENTS ON EXIT: 
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SUP-53. Checkpoint/Restart Exit Routine Router (IEAVCKRS) 
ZEAVCKRS - DIAGNOSTIC AIDS (Continued) 


EXIT NORMAL: 

0-13 Unchanged 

14 Return address 

15 Rotum code 

EXIT ERROR: 

0-13 Unchanged 

14 Return address 

15 Return code 
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SUP-53. Checkpoint/Restart Exit Routine Router (IEAVCKRS) 

XEAVCKRS - Checkpoint/Restart Exit Routine Router STEP 


Checkpoint/Restart 

t- 

XEAVCKRS 


SSCR j-> 

I SSCRCKRS SSCRBKC I 


Chackpoint/Restart passes control to this 
Supervisor Control module (IEAVCKRS) (via 
the entry point address in CVTCSPIE ) which 
is responsible for calling the appropriate 
exit routines to perform 
Checkpoint/Restart processing, 

IEAVCKRS is called by Checkpoint/Restart 
three times (twice for the Checkpoint and 
once for the Restart) to invoke the 
appropriate exit routines. Each time, 
register one will point to a queue of at 
least one SSCR (Subsystem Checkpoint 
Record). The SSCRCKRS and SSCRBKC bits 
within the first SSCR will be set as 
follows: 

- First call - SSCRCKRS = 1 SSCRBKC = 1 

- Second call - SSCRCKRS = 1 SSCRBKC = 0 

- Third call - SSCRCKRS = 0 SSCRBKC is 
unused 

The first call is a request to return the 
number of SSCRs needed to checkpoint the 
task. The Exit Routines are responsible 
for returning the number of SSCRs they 
require. On the second call, 
Chockpoint/Rcstart passes a queue of the 
requested SSCRs to IEAVCKRS. The Exit 
-Routines are responsible for storing the 
appropriate task related status in the 
SSCRs. On the third call, 
Checkpoint/Restart passes the same queue 
of SSCRs to IEAVCKRS. The exit routines 
are responsible for restoring the task's 
status from the SSCRs. 


01 


Save the address of the SSCR 
queue 


02 


LOAD each exit routine and 
save its entry point address 
in the EXITS? table 


03 


Decide whether to do "Count 
SSCR processing", 
"Checkpoint" processing, or 
"Restart" processing 


A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 



C 

C 

c 

c 

c 

c 


Call the CNTSSCRS 
procedure passing the 
address of the input SSCR 
/i-i\,- 

\i-1 / CNTSSCRS: 12 


HEADSSCR 


01 
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SUP-53. Checkpoint/Restart Exit Routine Router CIEAVCKRS) 

IEAVCKRS - Checkpoint/Restart Exit Routine Router STEP 


SSCR 

SSCRCKRS 


05 


Save the return code 


06 


Call the CHKPOINT 
procedure passing the 
address of the top SSCR 
on the queue 

/'-Ki- 


CHKPOINT: 25 


HEAOSSCR 


07 


Save the return code 


08 


Call the COMMON procedure 
passing the address of 
the top SSCR on the queue 

/i-1\.- 


COMMON: 42 


HEAOSSCR 


09 


Save the return code 


10 


11 


DELETE the exit routines 


Return with the appropriate 
return code 


[71 


05 
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SUP-53. Checkpoint/Restart Exit Routine Router (IEAVCKRS) 

XEAVCKRS - Checkpoint/Restart Exit Routine Router STEP 12 


PARAMETERS 


SSCRPTR 




12 


CNTSSCRS 

-*\ 

-1/ 


PARAMETERS 


PARAMETERS 


SSCRPTR 




PARAMETERS 


SSCRPTR 


SSCR 


SSCRBLKC 


PARAMETERS 


-K 

V 


—> 

-K 

V 


17 


18 


Place the address of the 
SSCR in register one for 
the exit routine call 


Call the exit routine 

/i-i X| - 

\i-1/ EXITRTN 



_l 

u 

— 1 field to zero for the exit 

- l/ 


SSCRPTR 


71 

being called 


SSCRBLKC 


12 


CNTSSCRS: Determine the 
number of SSCRs requested by 
the exit routines 


13 


14 


15 


16 


Zero the return code 


Initialize the count of 
SSCRs to one for the system 
SSCR 


Loop until all exit routines 
have been called or until a 
called exit routine returns 
a non-zero return code 


Initialize the SSCR count 


-KSSCR 


19 


If the exit routine was 
not successful ... 


20 


Construct the proper 
error return code 


211 The exit routine was 

successful. If the number 
of SSCRs requested by 
this exit routine is not 
negative? add the number 
to TOTSSCRS 


22 


23 


When the requested SSCR 
count is negative? 
construct the proper 
error return coda 


Place the total number of 


-KSSCR 



_J 

SSCRs requested m the SSCR 

- 1/ 


SSCRPTR 


to ba returned to 
Chackpoint/Restart 

SSCRBLKC 
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SUP-53. Checkpoint/Restart Exit Routine Router CIEAVCKRS) 

IEAVCKRS - Checkpoint/Restart Exit Routine Router STEP 24 


24 


Return with the return code 



PARAMETERS 


SYSSSCR 


■n 


-K 


25 


CHKPOINT 
- 1\ 

-,/ 


PARAMETERS 


SYSSSCR 


SSCR 


SSCROATA 


25 


26 


27 


28 


29 


30 


31 


CHKPOINT: Record the number 
of SSCRs required by each 
exit routine and initiate 
Checkpoint processing 


Clear the return code 
variable 


Clear the SYSTEM SSCR 


Set the SSCRCKRS bit to one 
to in the dummy SSCR to 
indicate Checkpoint 
processing should be done 


Set the SSCR2KC bit in the 
dummy SSCR to tell the exit 
a count of required SSCRs is 
requested 


Call each exit routine to 
retrieve the number of SSCRs 
requested and store the 
number in an exit associated 
slot in EXITSSCRCNT within 
the system SSCR 


Place the address of the 
dummy SSCR in register one 
for the call to the exit 
routine 


-*\SSCR 
V[ 


SSCRCKRS 


-*\SSCR 

Vi 


SSCRBKC 


32 


Call the exit routine 
/i - 1 \,- 

-i/I EXITRTN 

I_ 


-KSSCR 


SSCRBLKC 


33 


If the exit routine was 
not successful ... 


34 


Construct the proper 
error return code 
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SUP-53. Checkpoint/Restart Exit Routine Router (IEAVCKRS) 

IEAVCKRS - Checkpoint/Restart Exit Routine Router STEP 35 


PARAMETERS 


SYSSSCR 


SSCR 


SSCRBLKC 


PARAMETERS 


SYSSSCR SSCRPTR 


SSCR 


SSCRFCHN 


1 / 


—> 
->\ 
V 


35 


Else* the exit routine 
was successful. Record 
the number of SSCRs 
requested by this exit 
routine in the SYSTEM 
SSCR 


36 


If the number of SSCRs 
needed for the Checkpoint 
has changed since the 
first call to IEAVCKRS ... 


37 


Construct the proper 
error return cods 


33 


If all exit routines were 
processed successfully* 
invoke the COMMON routine to 
do the Checkpoint processing 


139 Call the COMMON routine 
'/i-1\.- 


COMMON: 42 


SYSSSCR 


AO Save the return code 


41 


Return with the return code 


-Kparameters 
-1/ 


SSCRPTR 


H 
\ / 
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SUP-53. Checkpoint/Restart Exit Routine Router (IEAVCKRS) 

IEAVCKRS - Checkpoint/Restart Exit Routine Router STEP 42 


PARAMETERS 


SYSSSCR 


n 


-»\ 


42 


- 1 / 


COMMON 


V 


PARAMETERS 


SYSSSCR 


SSCR 


SSCRFCHN 


—> 
J\ 
1/ 


PARAMETERS j--> 

SYSSSCR 1 


PARAMETERS 


SYSSSCR 


SSCR 


SSCRFCHN | 

r 

SSCR 

_r 

SSCRFCHN |— 




J\ 

1/ 



42 


COMMON: Invoke the exit 
routines to do Checkpoint or 
Restart processing 


43 


Clear the return code 
variable 



Set PIRSTSSCR to the first 
non-system SSCR on the 
queue. (The first SSCR 
belonging to the first exit 
routine to be called) 


45 


Process each exit routine 
until there are no more exit 
routines to call or an exit 
routine passes back a 
non-zero return code 


A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 


46 


Initialize LASTSSCR to 
point to the first SSCR 
on the queue belonging to 
this exit routine 


47 


Find the SSCR in the 
queue which is the last 
SSCR belonging to the 
exit routine being 
processed 


48 


Save the forward pointer 
of the current exit's 
last SSCR 



Zero the forward pointer 
of the current exit's 
last SSCR. This is done 
to prevent the called 
exit routine from 
altering SSCRs not 
belonging to it 


50 


Set the SSCRCKRS and 
SSCRBKC bits in the exit 
routine's first SSCR to 
tell the exit routine 
whether to do Checkpoint 
or Restart processing 


51 


Place the address of the 
exit routine's first SSCR 
in register one 


J\SSCR 


i/ 


SSCRFCHN 


J \SSCR 




SSCRFLG1 
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SUP-53, Checkpoint/Restart Exit Routine Router (IEAVCKRS) 

IEAVCKRS - Checkpoint/Restart Exit Routine Router STEP 52 



IEAVCRVF - MODULE DESCRIPTION 


DESCRIPTIVE NAME: Vector Checkpoint/Restart Exit Routine 
FUNCTION: 

IEAVCRVF is responsible for saving or restoring the subject 
task • s vector related status during a Checkpoint or Restart 
operation. 

IEAVCRVF is called by the Supervisor Checkpoint/Restart Router 
module (IEAVCKRS) three times (twice for Checkpoint processing 
and once for Restart processing) to perform the Checkpoint and 
Restart processing. Each time> register one contains the 
address of a queue of at least one SSCR (Subsystem Checkpoint 
Record). The SSCRCKRS and SSCR8KC bits within the first SSCR 
will be set as follows. 

First call - SSCRCKRS = 1 SSCRBKC = 1 

Second call - SSCRCKRS = 1 SSCRBKC = 0 

Third call - SSCRCKRS = 0 SSCRBKC is unused 

The first call is a request to return the number of SSCRs 
needed to checkpoint the task. On the second call> IEAVCKRS 
passes a queue of the requested SSCRs to IEAVCRVF. The exit 
routine is responsible for storing the appropriate vector 
related status in the SSCRs. On the third call* IEAVCKRS 
passes the same queue of SSCRs to IEAVCRVF. The exit routine 
is responsible for restoring the task's vector status from the 
SSCRs. 
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SUP-54. VECTOR CHECKPOINT/RESTART EXIT ROUTINE HEAVCRVF) 


ENTRY POINT: IEAVCRVF 
PURPOSE: Refer to the module function topic 
LINKAGE: Branch entered 

CALLERS: IEAVCKRS (Supervisor Checkpoint/Restart Router) 

INPUT: 

- The subject task’s TCB referenced via PSATOLD 

- A queue of one or more SSCRs pointed to by register 

one upon entry 

- The SSCRCKRS and SSCRBKC bits in the first SSCR on 

the queue 

- The Vector Status Save Area of a task using the 

vector facility 

- The STCBVSSA pointer from the subject task 

- The CVTVSS and CBLVSSA fields 
OUTPUT: 

- SSCRBLKC set to the total of SSCRs needed to checkpoint 

the task’s vector status (When SSCRCKRS and SSCRBKC are 
set to on8) 

- The task's vector status saved in the queue of SSCRs 

(When SSCRCKRS is set to one and SSCRBKC is zero) 

- The task's VSSA (obtained by the Vector SLIH) restored 

from the data in the queue of SSCRs (When SSCRCKRS 
is zero) 

- Return code in register IS 

EXIT NORMAL: To IEAVCKRS with return code in register 15 
ENTRY POINT: CRVFRRTN 
PURPOSE: Provide recovery for the IEAVCRVF mainline. 

LINKAGE: Branch entered 

CALLERS: RTM 

INPUT: 

- Values placed in the FRR parameter area by the 

mainline for registers 11 through 13 

- The address of the mainline return code field 

placed in the FRR parameter area by the mainline 

- The address of the top SSCR on the queue for 

recording purposes only (placed in the FRR parameter 
area by the mainline) 

- The SDWACMPC and SOWAHRC fields in the SDWA 

- The STCBVSSA field of the subject task 
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SUP-54. Vector Checkpoint/Restart Exit Routine (IEAVCRVF) 

1EAVCRVF - MODULE DESCRIPTION (Continued) 

OUTPUT: 

- Standard error diagnostic information recorded in the 

SDWA 

- The appropriate SDWA fields for RETRY communication 

to RTM 

- The SSCRHDR area from the head of the input SSCR queue 

recorded in the VRA 

- The FRR parameter area recorded in the VRA 

- The mainline return code field set to the appropriate 

value 

- The STCBVAFN and TCBAFFN fields reset to reflect "stolen" 

vector affinity 

- The vector control bit in Control Register Zero set to 

zero by the Dispatcher via the CALLDISP macro 

EXIT NORMAL: To RTM 

EXTERNAL REFERENCES: 

ROUTINES: None 


CONTROL BLOCKS: 

CBLS (Control Block Lengths Table) - (r) 

CVT (Communication Vector Table) - (r) 

FRRS (Functional Recovery Routine Stack) - (r,w) 

PSA (Prefixed Save Area) - (r) 

SDWA (System Diagnostic Work Area) - (r>w) 

SSCR (Subsystem Checkpoint Record) - (r>w) 

STCB (Secondary Task Control Block) - (r>w) 

SVT (Supervisor Vector Table) - (r) 

TCB (Task Control Block) - (r f w) 

VSSA (Vector Status Save Area) - (r>w) 


r = Read 
w = Write 


SERIALIZATION: 

STCBVAFN is set to zero to ensure that the Dispatcher 
and Stop/Reset do not attempt to save vector status 
while IEAVCRVF is altering the task's VSSA during 
Restart processing. 
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SUP-54. Vector Checkpoint/Restart Exit Routine (IEAVCRVF) 
IEAVCRVF - MODULE OPERATION 


IEAVCRVF will set an EUT type FRR which will pass control to 
an internal recovery routine (CRVFRRTN) should an error occur. 
SVCs cannot be issued while the EUT FRR is in place. The 
values from registers 11, 12, and 13 will be saved in the FRR 
parameter area to allow use in the recovery routine. 

Registers 11 through 13 contain the address of the data area, 
the module base address, and the address of the general 
register save area. 


The SSCRCKRS bit in the first SSCR of the input SSCR queue 
will then be examined. If the SSCRCKRS bit is one, the SSCRBKC 
will be examined. If it is one, "CNTSSCRS” processing will be 
performed. If the SSCR2KC bit is zero, "CHXPOINT" processing 
will be performed. If the SSCRCKRS bit is zero, "RESTART” 
processing will be done. The return code from the called 
subroutine will be saved. 


The EUT FRR will then be deleted and control will pass to the 
caller with the saved return code. 


"CNTSSCRS" Processing 

PSATOLD will be used to gain addressability to the subject 
TCB. STC3VSSA will then be compared to zero. If it is zero, 
the SSCR2LKC field within the first input SSCR will bo set to 
zero to indicate no vector checkpoint will be done. 


If STCSVSSA is non-zero, IEAVCRVF will calculate the number of 
SSCR blocks needed to checkpoint the task's Vector Status Save 
Area (VSSA). The size of the VSSA will be obtained by 
multiplying the vector section size lthe value in CVTVSS) by 
64 and adding the size of the static portion of the VSSA 
(CBLVSSA) to the result. The number of SSCRs needed to store 
the VSSA will be placed in the SSCRBLKC field of the first 
SSCR on the input SSCR queue. When calculating the number of 
SSCR blocks, remember VSSA data will bo stored in the SSCROATA 
fields only. 


"CHKPOINT" Processing 

The VSSA will be validity checked via the LRA instruction 
and "VSSA” acronym checks. If the STCBVSSA does not point to 
a valid VSSA, control will be passed to Ihc nailer with a 
return code of X'CV. Otherwise- a "CAI.LDISP BRAKCK-YcS, 
FIXED=NO,FRRSTK=SAVE” will be issued to cause the dispatcher 
to save the task's vector status in the VSSA. Khcn IEAVCRVF 
is re-dispatched, the STCBVNCK bit will be checked to 
determine whether vector status for the task was lost due to 
a machine check. If so, control will be passed to the caller 
with a return code of X'20'. 


If vector status for the task was saved successfully, 
the task's VSSA will then be copied into the SSCRDATA fields 
of successive elements of the input SSCR queue. The current 
level number of the VSSA (CBLVSSAL) will be stored in the in 
the first SSCR at the VSSARPTR field location. Tho actual 
VSSARPTR value is not needed for the Restart operation. The 
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SUP-54. Vector Checkpoint/Restart Exit Routine (IEAVCRVF) 

IEAVCRVF - MODULE OPERATION (Continued l 


saved CBLVSSAL value will be compared to the level of the VSSA 
at the time of the Restart to ensure VSSA compatibility. 


"RESTART" Processing 

This processing will restore the task's vector status on a 
restart operation. 


A simple vector instruction will be issued (VXVC, Extract 
Vector Count). This will cause the vector SLIH to build and 
initialize a vector environment for the tosk. After the 
vector instruction is issued, STCBVAFN will be zeroed. This 
will stop the Dispatcher and Stop/Rcset from saving/restoring 
vector status for the task while IEAVCRVF is restoring the 
VSSA. TCBAFFN will then be set to the value in STCBAFNS. A 
"CALLDISP BRANGH=Y E S,FIXED =N0,FRRSTK=SAVE" will then bo issued 
to cause the dispatcher to turn off the vector control bit in 
control register 0. To turn off the vector control bit in 
IEAVCRVF would require disablement to serialize the PSACROSV 
field. 


When IEAVCRVF is re-dispatched, the VSSA will bo validity 
checked via the LRA instruction and "VSSA" acronym checks. If 
the STCBVSSA does not point to a valid VSSA> control will be 
passed to the caller with a return code of X'04 1 . 


The Vector section size recorded in the SSCR data area at 
Checkpoint time will be compared against the current section 
size. If the section sizes are not equal, control will bo 
passed to the caller with a return code of X'10'. 


The VSSA level number saved in the SSCR data area at 
Checkpoint time will be compared against the current VSSA 
level number in the CBLS..If they are not equal, control will 
be passed to the caller with a return code of X a 14'. 


Appropriate VSSA fields will then be copied from the queue of 
SSCR blocks to the task's VSSA. (The VSSA was created as a 
result of the vector instruction issued. ) 

RECOVERY OPERATION: 

The FRR Routine (CRVFRRTN) will be responsible for recording 
standard diagnostic information in the SDNA. Also, FRR 
parmeter area data and other message text will be recorded in 
the VRA. 


The FRR will then determine whether the error was caused 
because none of the online vector processors meets the 
task's affinity requirements, because there is no vector 
processing capability in the complex, because the 
VSSA could not be obtained by the Vector SLIH, or because of 
an unexpected program check. If the Vector SLIH initiated a 
X'09F' reason code X'08' ABEND, the return code field from the 
mainline will be set to X'08 1 . The address of the return code 
field was passed to the recovery routine in the FRR parameter 
area. If the Vector SLIH initiated a X‘09F' reason coda X'OC' 
ABEND, the return code field from the mainline will be set to 
X'OC'. If the Vector SLIH initiated a X'09F' reason code 
X'24* ABEND or if the VXVC instruction issued by the Restart 
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SUP-54. Vector Checkpoint/Restart Exit Routine (IEAVCRVF) 
IEAVCRVF - MODULE OPERATION (Continued) 


routine in this module resulted in a X'OCl' ABEND> the 
return code field will be set to X‘18*. In all other cases> 
the return code field will be set to X'lC’ to indicate an 
unexpected error occurred. 


If the task had obtained a VSSA> vector affinity will be 
stolen in the following way. STCBVAFN will be set to zero and 
TCBAFFN will be set to STC3AFNS. A "CALLDISP BRANCH=YES, 
FIXED-NO* FRRSTK=SAVE" will then be issued to cause the 
dispatcher to turn off the vector control bit in control 
register 0. 


The FRR will retry to label CRVFEXIT in IEAVCRVF where the FRR 
will be deleted and where control will be passed to the caller 
with the appropriate mainline return code. 
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SUP-54. Vector Checkpoint/Restart Exit Routine (IEAVCRVF) 
IEAVCRVP - DIAGNOSTIC AIDS 

ENTRY POINT NAMES: IEAVCRVF 

CRVFRRTN 


MESSAGES: None 


ABEND CODES: None 


WAIT STATE CODES: None 


RETURN CODES: 

ENTRY POINT IEAVCRVF: 

EXIT NORMAL: 

Return codes are presented to the caller in register 15. 
Return code Explanation 


X'00000000* IEAVCRVF processing was 
successful. 

EXIT ERROR: 

Return codes are presented to the caller in register 15. 
Return code Explanation 


X*00000004* IEAVCRVF has detected an invalid 
pointer to the subject task's 
VSSA. 

X*00000008* The Vector SLIH has determined 
that none of the online vector 
processors meets the task's 
affinity requirements. 

X*0000000C* The Vector SLIH could not 
obtain a VSSA for the task. 

X'00000010* The vector section size recorded 
for the Checkpoint is not equal 
to the vector section size for 
the Restart. 

X*00000014* The mapping of the Vector Status 

Save Area (VSSA) has changed from 
the time the Checkpoint was taken 
to the time the Restart was attempted. 

X'00000018' There exists no vector processor 
in the complex. 

X'OOOOOOIC* An unexpected error has occurred. 

X*00000020' Vector status has been lost due to 
a machine check. 


Exit routines invoked by IEAVCKRS are assigned a one 
byte unique exit routine ID. IEAVCRVF’s ID is X'03'. 
When one of the above error return codes is passed 
back to IEAVCKRS> it is concatenated with the ID 
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IEAVCRVF - DIAGNOSTIC AIDS (Continued) 


and returned to Checkpoint/Restart. 
ENTRY POINT CRVFRRTN: None 


REGISTER CONTENTS ON ENTRY: 

ENTRY POINT IEAVCRVF: 

0 - Irrelevant 
1 - Address of SSCR Queue 
2-12 - Irrelevant 

13 - Address of 18 Word Save Area 

14 - Return Address 

15 - Entry Point Address 

ENTRY POINT CRVFRRTN: 

0 - Address of a 200 byto FRR work area (Unused) 
1 - Address of the SDWA 
2-13 - Irrelevant 

14 - RTM return address 

15 - Entry point address 


REGISTER CONTENTS ON EXIT: 

ENTRY POINT IEAVCRVF: 

EXIT NORMAL: 

0-13 Unchanged 

14 Return address 

15 Return code 

EXIT ERROR: 

0-13 Unchanged 

14 Return address 

15 Return code 

ENTRY POINT CRVFRRTN: 

EXIT NORMAL: 

0-13 Irrelevant 

14 Return address 

15 Irrelevant 
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SUP-54. Vector Checkpoint/Restart Exit Routine (IEAVCRVF) 

IEAVCRVF - Vector Checkpoint/Restart Exit Routine STEP 01 


IEAVCKRS (Supervisor 
Checkpoint/Restart Router) 



IEAVCRVF 


PSA r -> 


PSANSTK 


FRRS 

_j 

FRRSCURR FRRSPARM 


PSA 


PSACSTK | 


FRRS 

FRRSRSA | 

1 

J"* 

SSCR 

SSCRCKRS SSCRBKC 



IEAVCRVF is responsible for saving or 
restoring the subject task's vector 
related status during a Checkpoint or 
Restart operation. 

IEAVCRVF is called by the Supervisor 
Checkpoint/Restart Router module 
(IEAVCKRS) three times (twice for 
Checkpoint processing and once for Restart 
processing) to perform the Checkpoint and 
Restart processing. Each time, register 
one contains the address of a queue of at 
least one SSCR (Subsystem Checkpoint 
Record). The SSCRCKRS and SSCRBKC bits 
within the first SSCR will be set as 
follows. 

First call - SSCRCKRS = 1 SSCRBKC = 1 
Second call - SSCRCKRS = 1 SSCRBKC = 0 
Third call - SSCRCKRS = 0 SSCRBKC is 
unused 

The first call is a request to return the 
number of SSCRs needed to checkpoint the 
task. On the second call* IEAVCKRS passes 
a queue of the requested SSCRs to 
IEAVCRVF. The exit routine is responsible 
for storing the appropriate vector related 
status in the SSCRs. On the third call, 
IEAVCKRS passes the same queue of SSCRs to 
IEAVCRVF. The.exit routine is responsible 
for restoring the task's vector status 
from the SSCRs. 



Save the address of the SSCR 
queue 



Set up recovery for IEAVCRVF 



Decide whether to perform 
CNTSSCRS processing, 
CHKPOINT processing* or 
RESTART processing 


A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 



Call the CNTSSCRS 
procedure passing the 
address of the SSCR queue 

\,-,/ CNTSSCRS: 12 


HEADSSCR 


>PSA 


[ 

-KP 


PSACSTK 


\PSA 

/,- 


n 

J 


PSANSS 


\FRRS 

/i- 


FRRSRSA 
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XEAVCRVF - Vector Checkpoint/Restart Exit Routine STEP 05 
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IEAVCRVF - Vector Chsckpoint/Restart Exit Routine STEP 12 






LRA0K1 
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SUP-54. Vector Checkpoint/Restart Exit Routine (IEAVCRVF) 

IEAVCRVF - Vector Checkpoint/Restart Exit Routine STEP 22 




Otherwise . . . 


A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 



Force an entry into the 
dispatcher to cause the 
vector status for the task 
to be saved in the VSSA 



If vector status for the 
task was not saved in the 
VSSA due to a machine 
check,.. 


25 


Set the return code to 
indicate vector status 
has been lost due to a 
machine check 



Otherwise... 


8 

B 

8 

B 

8 

B 

B 

B 

B 

B 

B 

B 

B 

3 

B 

B 

B 

B 

B 

8 

B 

B 

B 

B 

B 


27 


Initialize the Current 
SSCR pointer to the 
address of the first SSCR 
on the queue 


28 


Store the static portion 
of the VSSA into the 
SSCRDATA area of the 
first SSCR on the queue 



Store the current level 
of the VSSA into the SSCR 


for use by the RESTART 
routine. 


-^PARAMETERS 

V 


SSCRPTR 
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ZEAVCRVF - Vector Checkpoint/Restart Exit Routine 


STEP 30 


PARAMETERS 



SSCRFCHN 


A 

B 

A 

B 

A 

B 

A 

B 

A 

B 

A 

B 

A 

B 

A 

B 

A 

B 

A 

B 

A 

B 


Store the vector register 
data from the task's VSSA 
into the SSCRs on the 
queue 


31 Return to the caller with 
1 — 1 the return code 


•NPARAMETERS 


SSCRPTR 


HEAOSSCR 


32 RESTART: Restore the task's 
— 1 vector status from the SSCRs 


Issue a vector instruction 
to cause a vector operation 
exception. This will cause 
the Vector SLIH to obtain a 
VSSA for the task and 
initialize the vector 
environment 



Steal the task's vector 
affinity so that the 
Dispatcher and Stop/Reset 
will not save vector status 
while IEAVCRVF is altering 
the task's VSSA 


KTCB 

\/i - 

TCBAFFN 


35 Force an entry into the 
— 1 Dispatcher to cause the 
vector control bit in 
Control Register Zero to be 
turned off 


36 Set the return code field to 
1 — 1 zero 


37 Validate the pointer to the 
1 — 1 task’s VSSA 


lraok 2 38 If the STCBVSSA pointer does 
1 — 1 not point to a valid VSSA 
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IEAVCRVF - Vector Checkpoint/Restart Exit Routine 


STEP 39 


Set the return code to 
indicate the pointer to 
the VSSA is invalid 


40 Otherwise ... 


PARAMETERS 


Initialize the current 
SSCR pointer to the 
address of the first SSCR 
on the queue 


^PARAMETERS 

l/\ - 1 

SSCRPTR 


ISSCRDATA 


PARAMETERS 


HEADSSCR 


If the section size from 
the checkpoint is not 
equal to the current 
section size ... 


Set the return code to 
indicate the vector 
section size from the 
checkpoint operation is 
not compatible with the 
current vector section 
size 


44 If the current VSSA is 
— J not compatible with the 
r VSSA that was current at 
Checkpoint time ... 


Set the return code to 
indicate the VSSA from 
the checkpoint 
operation is not 
compatible 'with the 
current VSSA 


46 Restore the VSSAVSR field 


SSCR 


SSCROATA 


47 Restore the VSSAVMR 
1 - 1 field 
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IEAVCRVF - Vector Checkpoint/Restart Exit Routine STEP 59 


SDWA j-> 

SDWACMPC 

SDWA r-> 


SDWACMPC 


SDWA j-> 

SDWACMPCI 


PSA 

Ipsatold 



J\ 


59 


Determine whether the error 
was caused because none of 
the online vector processors 
meats the task's affinity 
requirements* the VSSA could 
not be obtained* there is no 
vector processing capability 
in the complex* or an 
unexpected error occurred. 


601 When the VSSA could not be 
obtained for the task* set 
the mainline return code 
to X'OC' 


61 


When none of the online 
vector processors meets 
the task's affinity 
requirements* set the 
mainline return code to 
X' 08' 


62 


When there exists no 
vector processing 
capability in the complex* 
set the mainline return - 
code to X'18' 


63 


Otherwise* an unexpected 
error has occurred ... 


64 


65 


Ensure that the task 
does not possess vector 
affinity and turn off 
the vector control bit 
in Control Register 
Zero 


Set the mainline return 
code to X'lC' 


66 Tell RTM to retry at 

IEAVCRVF label CRVFEXIT 


671 Restore the RTM return 
address 


68 


Return to RTM 


In 


\ / 


J \TCB 


1 / 


TCBAFFN 


J\SDWA 


SDHASR1I 

SDWASR12 

SDHASR13 
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SUP-54. Vector Checkpoint/Restart Exit Routine (IEAVCRVF) 

IEAVCRVF - Vector Checkpoint/Restart Exit Routine STEP 48 


PARAMETERS 


SSCRPTR 


SSCR 


SSCRDATA 


SSCR 


SSCRFCHN 


—> 
-A 
~\S 


RESEXIT1 


A 

B 

C 

A 

B 

C 

A 

B 

C 

A 

B 

C 

A 

B 

C 

A 

B 

C 

A 

B 

C 

A 

B 

c 

A 

B 

c 

A 

B 

c 

A 

B 

c 


48 


Restore the vector 
register data from the 
SSCRs to the task's 
VSSA 



Return to the caller with 
the return code 


J \PARAMETERS 

V 


SSCRPTR 




SDWA 

SDMAPARM 


SDWA 

IsDWAPARM 


RTM 



CRVFRRTN 



A 

V 


50 


CRVFRRTN: Recovery 
processing for IEAVCRVF 


51 


Get data area addressability 


52 


Get addressability to the 
SDWA 


53 


Get addressability to the 
FRR parameter area set up by 
the mainline 


54 


55 


Establish module base 
addressability 


Save the return address to 
RTM 



Record standard diagnostic 
information in the SDWA 



Record the FRR parameter 
area in the VRA 


58 


Record the SSCRHDR area of 
the first SSCR on the input 
queue of SSCRs 


ASDWA 


SDWAMODN 

SDWACSCT 

SDHAREXN 

SDWACID 

SDNASC 

SDWAMLVL 

SDWARRL 
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SUP-55. VECTOR SECOND LEVEL INTERRUPT HANDLER [IEAVEVS) 
IEAVEVS - MODULE DESCRIPTION 


DESCRIPTIVE NAME: Vector Second Level Interrupt Handler 
FUNCTION: 

The vector SLIH receives control from the program FLIH upon 
detection of a program interrupt code x'19*. The SLIH is 
responsible for the creation and restoration of the vector 
environment of a task issuing vector instructions. 

ENTRY POINT: IEAVEVS 

PURPOSE: 

This entry point is responsible for the creation and 
restoration of the vector environment of a task issuing 
vector instructions. For detailed description of the 
operation in this entry point* refer to the OPERATION 
section. 

LINKAGE: 

BASR R14*R15 

Address of 18 word save area in R13 
CALLERS: IEAVEPC (DAT-ON Program Check FLIH) 

INPUT: 

- ASCB referenced by PSAAOLD. 

- ASSB referenced by ASCBASSB. 

- TCB referenced by PSATOLD. 

- STCB vector related status indicators. 

- Online processor masks resident in the PCCA and CSD. 

- Control Register Zero. 

- Old Program check PSW resident in the LCCA. 

- Current lock held string indicators in the PSA. 

- SRB and task mode indicators in the PSA. 

OUTPUT: 

- The Vector Status Save Area (VSSA) initialized and 

chained from the STCB (If first time vector user). 

- STCB vector related status indicators. 

- Control Register Zero (bit 14) is set to one. 

- Vector Activity Count saved in VSSAEVST. 

- Return code in register 15, 

EXIT NORMAL: To the Program Check FLIH with return code in R15. 

EXIT ERROR: 

To the Program Check FLIH with return code in R15 
and associated reason code in RO. 

ENTRY POINT: IEAVVRTM 

PURPOSE: 

IEAVVRTM clears the STCBVFRB and STCBPIQ fields to tell the 
SRB's (scheduled by the vector SLIH)* RTM is in the process 
of abnormally terminating the task. When the vector SLIH 
schedules an SRB* the address of the current RB (the one 
STOPped by the vector SLIH)* is placed in STCBVFRB. This 
field is compared against the STOPped RB in the SRB routine 
to ensure RTM processing has not made the task active. The 
SRB routine will perform the corresponding RESET only when 
the STOPped RB (passed in the SRBPARM area) matches the RB 
in STCBVFRB. RTM calls this entry point to zero the 
STCBVFRB field prior to making the task active. This 
mechanism allows the SRB routine to detect asynchronous 
ABTERM processing against the task. The STCBVFRB field is 
serialized between the vector SLIH and the SRB routine with 
the dispatcher lock. The field is serialized between the 
vector SLIH and the IEAVVRTM routine with TCBACTIV and 
disablement* (RTM STATUS STOPs the task for ABTERM 
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SUP-55. Vector Second Level Interrupt Handler (IEAVEVS) 
IEAVEVS - MODULE DESCRIPTION (Continued) 


processing). The STCBVFR8 is serialized between the SRB 
routine and IEAWRTM with the local lock (RTM obtains 
home's local lock to initiate A3TERM processing). 

LINKAGE: 

BALR R14>R15 

General registers 0-15 area saved in the PSASLSA 
after entry to IEAWRTM. 

CALLERS: IEAVTRTM (RTM termination processing) 

INPUT: 

- TCB passed in register 3. 

- STCB fields STCBVFRB and STCBPIQ. 

OUTPUT: - STCBVFRB and STCBPIQ are cleared to zero. 

EXIT NORMAL: To the caller with return code in R15. 

EXIT ERROR: To the caller with return code in R15. 

ENTRY POINT: IEAVVFGM 

PURPOSE: 

IEAWFGM obtains and initializes the vector status save 
area (VSSA) for the first time vector user. For detailed 
description of the operation in this entry point* refer to 
the OPERATION section. 

LINKAGE: 

BASR R14>R15 

Address of 18 word register save area in R13 
CALLERS: 

IEAVEVS (Vector Second Level Interrupt Handler) 

IEAVVSRB (Vector Obtain VSSA SRB routine) 

INPUT: 

- Key fields in the Vector Work Area (VECWA). 

- ASCB referenced by PSAAOLD. 

- TCB passed in VFGMTCBS) within Vector Work Area. 

- Vector section size contained in CVTVSS. 

OUTPUT: 

- The Vector Status Save Area (VSSA) initialized and 

chained from the STCB. 

- Return code in register 15. 

EXIT NORMAL: To the caller with return code in R15. 

EXIT ERROR: To the caller with return code in R15. 

EXTERNAL REFERENCES: 


ROUTINES: 

IEAVECMS - (CMSET Routine) 

IEAVELK - (Spin Lock Manager) 

IEAVESC0 - (SCHEDULE Service Routine) 

IEAVESLK - (Suspend Lock Manager) 

IEAVESPM - (SRB Pool Manager) 

IEAVESRT - (STOP/RESET) 

IEAVGN00 - (GETMAIN - FREEMAIN Routine) 

IEAVVSRB - (Vector Environment Create SRB Routine) 


DATA AREAS: IHAVECWA maps the SCWVSLIH area in the SCWA. 
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SUP-55. Vector Second Level Interrupt Handler (IEAVEVS) 
IEAVEVS - MODULE DESCRIPTION (Continued) 

CONTROL BLOCKS: 


ASCB 

(Address Space Control Block) 

- 

(r) 

ASSB 

(Address Space Secondary Block) 

- 

( r,w) 

CBLS 

(Control Block Lengths Table) 

- 

(r) 

CSD 

(Common System Data Area) 

- 

(r) 

CVT 

(Communication Vector Table) 

- 

(r) 

FRRS 

(Functional Recovery Routine Stack) 

- 

(r,w) 

LCCA 

(Logical Communication Configuration Area) 

- 

(r) 

PCCA 

(Physical Communication Configuration Area) 

- 

( r) 

PSA 

(Prefixed Save Area) 

- 

(r, w) 

RB 

(Request Block) 

- 

(r,w) 

SCWA 

(Supervisor Control Work Area) 

- 

( r ,w) 

SRB 

(Service Request Block) 

- 

(o,r,w) 

STCB 

(Secondary Task Control Block) 

- 

(r,w) 

SVT 

(Supervisor Vector Table) 

- 

(r) 

TCB 

(Task Control Block) 

- 

(r,w) 

VECWA 

(Vector Work Area) maps the SCWVSLIH area 

- 

(r,w) 

VSSA 

(Vector Status Save Area) 

- 

(c,r ,w) 

XSB 

(Extended Status Block) 

- 

(r,w) 


r = Read 
w = Write 

c = Create (GETMAIN is done in this module) 
o = Obtain (Control block is obtained via service 
routine call) 

SERIALIZATION: 

(For IEAVEVS entry point... ) 

- Obtains and releases Home's Local Lock for the VSSA 

GETMAIN processing. 

- Obtains and releases the Dispatcher Lock to serialize 

fields ASSBVAFN, CSDCPUVF, and STCBVFRB. 

- Sets STCBPIQ under TCBACTIV to prohibit IRB queuing 

by the STAGE 3 exit effector. 

- Legally Disabled for I/O, EXTERNAL interrupts 

upon entry. 

(For IEAWRTM entry point... ) 

- Home's Local Lock held upon entry. 

- Disabled for I/O, EXTERNAL interrupts. 

(For IEAWFGM entry point...) 

- Legally Disabled for I/O, EXTERNAL interrupts 

upon entry. 

- Home's Local Lock held upon entry. 
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SUP-55. Vector Second Level Interrupt Handler CIEAVEVS) 
IEAVEVS - MODULE OPERATION 


(OPERATION FOR ENTRY POINT IEAVEVS) ... 

After standard entry linkage is performed> the SLIH ensures 
that the processor is in task node. If not, control is returned 
to tho program FLIH with the appropriate return code. 
Addressability is then established to the home address space 
via CNSET to PSAAOLD, A CMSET RESET is performed prior to exit. 
The SLIH than validates tho TCBSTCB pointer and decides whether 
to create a task's VF environment, restore the task's VF 
environment from the VSSA, or simply reset the vector control 
bit in control register zero. 


CREATION OF THE VF ENVIRONMENT 


When the first vector instruction is issued by a task, the SLIH 
knows to create the VF environment because the pointer to the 
VSSA (STCBVSSA) is zero. In this situation, the following 
restrictions apply: 

- The task must be running enabled for I/O and external 

interrupts, 

- The task must be unlocked. 

- When VFs are online, there must exist at least one vector 

engine to which the task has affinity. 

- VF capability must exist in the complex. That is, the VF 
hardware must be installed and a VF must have been online 
at some point during this ipl (although VFs may currently 
all bo offline). 

If any of these requirements are violated, control is returned 
to the program FLIH with the appropriate return code (reference 
the RETURN CODE section below). This path through the vector 
SLIH holds the Dispatcher lock to serialize the manipulation of 
the AS5BVAFN field. The lock insures the integrity of ASSBVAFN 
and prohibits Reconfiguration from taking a candidate vector 
engine off-line before the task has a chance to claim affinity 
to it. The SLIH then issues a conditional obtain for the local 
lock. If the lock is not obtained, the task is suspended via a 
call to STOP/RESET and a local SRB is scheduled (with tho local 
lock and FRR required) to run on a CP/VF to create tho task's 
vector environ;nont. Module IEAVVSR3 serves as the SRB routine. 
Also, STCBVFRB is set to the address of the STOPped RB to tell 
the SR3 routine the task has been suspended. This communication 
is necessary since RTM may initiate ABTERM processing against 
the task which results in the task becoming active. Supervisor 
Control has provided RTM an entry point (IEAVVRTM) in this 
module which is called to zero the STCBVFRB field before the 
task becomes active. The SRB routine performs its function 
only when the contents of STCBVFRB equals the address of the 
STOPped RB. After the SRB is scheduled, control is passed back 
to the program FLIH with the appropriate return code to 
indicate task preemption. If the local lock is obtained, the 
SLIH performs the necessary calculations for the size of the 
vector status save area and issues a conditional branch entry 
GETMAIN for the storage. If the GETMAIN fails, control passes 
to the program FLIH with the appropriate return code. The VSSA 
is then chained to the STCB (STCBVSSA) and initialized. The 
task's affinity is then saved in field STCBAFNS and TCBAFFN is 
replaced with a more restrictive affinity. TCBAFFN must be set 
to set to a more restrictive affinity (a value that is nonzero 
and not all ones ) so that the vector affinity checking path 
through the Dispatcher will be executed. The task's affinity 
will be recalculated in the Dispatcher using the value saved 
in STCBAFNS. Also, ASSBVAFN is incremented by one to indicate 
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SUP-55. Vector Second Level Interrupt Handler (IEAVEVS) 
IEAVEVS - MODULE OPERATION (Continued) 


there exists at least one task in the address space which has 
affinity to vector processors. 

The SLIH then determines if the current processor meets the 
task's restrictive affinity requirements. If not* the resume 
PSN* registers* and cross memory status is saved. Control is 
returned to the program FLIH with a return code which indicates 
preemption for the task. If the task has affinity to the 
current processor* bit 14 in control register zero is set* 
vector status is loaded from the VSSA and control is routed 
back to the program FLIH with a return code to indicate the 
task can continue. 


RESTORING THE VF ENVIRONMENT 


This processing takes place when the task executes a vector 
instruction after its vector affinity was taken away because of 
vector facility non-use (STCBVSSA is not zero and STCBVAFN is 
zero). In this situation* the following restrictions apply: 

- The task must be running enabled for I/O and external 

interrupts* 

- The task must be unlocked. 

- When VFs are online* there must exist at least one vector 

engine to which the task has affinity. 

- VF capability must exist in the complex. That is* the VF 
hardware must be installed and a VF must have been online 
at some point during this ipl (although VFs may currently 
all be offline). 

If any of these requirements are violated* control is returned 
to the program FLIH with the appropriate return code. The SLIH 
validates the pointer to the vector status save area with an 
LRA instruction and appropriate acronym checks. If the pointer 
is not valid* control is returned to the program FLIH with the 
appropriate return code. TCBAFFN is then replaced with a more 
restrictive affinity. The SLIH then determines if 
the current processor meets the task's affinity requirements. 

If not* the resume PSW* registers* and cross memory status is 
saved. Control is returned to the program FLIH with a return 
code which indicates preemption for the task. If the task has 
affinity to the current processor* bit 1* in control register 
zero is sot* vector status is loaded from the VSSA and control 
is routed back to the program FLIH with a return code to 
indicate the task can continue. 


RESETTING THE VECTOR CONTROL REGISTER BIT 


In certain circumstances* the BAT-OFF program FLIH may refresh 
control register zero bit 14 with a default value of zero. 
Because the DAT-OFF program FLIH cannot establish the TCB 
addressability necessary for vector task recognition* the FLIH 
does not maintain the integrity of the vector control bit. 

This condition is detected because of a non-zero pointer to 
the VSSA (indicating a non-first time vector operation) and a 
non-zero STCBVAFN field (indicating the task has affinity to a 
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